Get de la Compra

El Get de la Compra permite a los comercios resolver incosistencias en las transacciones y recuperar la información detallada de una compra específica.

Consulta por ID de Transacción

Para obtener información detallada de una transacción específica, debes realizar una petición GET a nuestros endpoints.

URL de la solicitud

Producción: https://api.bamboopayment.com/v3/api/Purchase/{{TransactionId}}
Pruebas: https://api.stage.bamboopayment.com/v3/api/Purchase/{{TransactionId}}

Donde {{TransactionId}} es el identificador de la transacción que desea consultar.

Recuerda incluir la Clave Privada del comercio en los encabezados de la petición.
Para más detalles, consulta nuestra Guía de Autenticación.

Uso de la API de Reportes

Para análisis de transacciones en masa y generación de informes, consulte nuestra API de Reporte de Transacciones, optimizada para manejar grandes volúmenes de datos y generar informes detallados.

Consulta por Número de Orden

Puedes obtener los detalles de una transacción utilizando el número de orden asignado por tu comercio.

URL de la solicitud

Realiza una petición GET a cualquiera de las siguientes URLs según tu ambiente:

Producción: https://api.bamboopayment.com/v3/api/Purchase/order/{{Order}}
Pruebas: https://api.stage.bamboopayment.com/v3/api/Purchase/order/{{Order}}

Donde {{Order}} es el número de orden que asignaste a la transacción que deseas consultar.

Recuerda incluir la Clave Privada del comercio en los encabezados de la petición.
Para más detalles, consulta nuestra Guía de Autenticación.

Consulta por ID Único

También puedes consultar una transacción utilizando un identificador único personalizado.

URL de la solicitud

Realiza una petición GET a cualquiera de las siguientes URLs según tu ambiente:

Producción: https://api.bamboopayment.com/v3/api/Purchase/uniqueId/{{UniqueId}}
Pruebas: https://api.stage.bamboopayment.com/v3/api/Purchase/uniqueId/{{UniqueId}}

Donde {{UniqueId}} es el identificador único personalizado asignado a la transacción.

Recuerda incluir la Clave Privada del comercio en los encabezados de la petición.
Para más detalles, consulta nuestra Guía de Autenticación.

Parámetros de respuesta

La estructura de respuesta para esta operación es idéntica a la respuesta estándar de compra. Esto garantiza consistencia entre diferentes tipos de transacciones y simplifica los procesos de integración.

Parámetro	Tipo	Descripción
`TransactionId`	`string`	Identificador único de la transacción. Un número de 19 dígitos enviado como cadena por compatibilidad.
`Result`	`string`	Resultado de la transacción. `COMPLETED` o `ACTION_REQUIRED`. Consulte el objeto “Action” para obtener instrucciones.
`Status`	`string`	Estado actual de la transacción (por ejemplo, Aprobada, Rechazada).
`ErrorCode`	`string`	Código de error si la transacción fue rechazada.
`ErrorDescription`	`string`	Descripción detallada del error si la transacción fue rechazada.
`Created`	`string`	Marca de tiempo de cuándo se creó la transacción, en formato ISO 8601.
`AuthorizationDate`	`string`	Marca de tiempo de cuándo se autorizó la transacción, en formato ISO 8601.
`AuthorizationCode`	`string`	Código único proporcionado por el emisor para confirmar la autorización de la transacción.
`Amount`	`integer`	Monto total de la transacción.
`Currency`	`string`	Código de la moneda utilizada para la transacción. Puede diferir de la moneda de la solicitud según los acuerdos comerciales.
`Installments`	`integer`	Número de cuotas de pago para la transacción.
`TaxableAmount`	`integer`	Monto sujeto a impuestos.
`Tip`	`integer`	Monto de la propina.
`Url`	`string`	Enlace para acceder a detalles adicionales de la transacción.
`MetadataOut`	`object`	Metadatos adicionales devueltos con la respuesta de la transacción.
`Action`	`object`	Detalles de las acciones requeridas cuando el Resultado es “ACTION_REQUIRED”.
`PaymentMethod`	`object`	Información del medio de pago utilizado

Ejemplo de respuesta

{
    "TransactionId": "79632697147789184",
    "Result": "COMPLETED",
    "Status": "APPROVED",
    "ErrorCode": null,
    "ErrorDescription": null,
    "Created": "2024-08-07T17:51:54.620",
    "AuthorizationDate": "2024-08-07T17:51:56.879",
    "AuthorizationCode": "839936",
    "Amount": 25000,
    "Currency": "BRL",
    "Installments": 2,
    "TaxableAmount": null,
    "Tip": null,
    "Url": "https://api.stage.bamboopayment.com/Purchase/79632697147789184",
    "MetadataOut": null,
    "Action": null,
    "PaymentMethod": {
        "Brand": "Visa",
        "CardOwner": "João Silva",
        "Bin": "450799",
        "IssuerBank": "Banco do Brasil",
        "Type": "CreditCard",
        "Expiration": "203008",
        "Last4": "4905"
    }
}

Nota

Todos los campos, estados y códigos de error descritos en la respuesta de compra se aplican igualmente al GET de la compra.

Última modificación 20 de diciembre de 2024