API de Movimientos Financieros

La API de Movimientos proporciona un reporte detallado de datos financieros. Permite obtener una visión general de los movimientos monetarios en la cuenta Bamboo en un periodo específico. Incluye créditos (fondos entrantes), débitos (pagos salientes o tarifas) y costos.

URL para el Request

Para acceder a la API de Reportes de Transacciones, debe realizar una solicitud GET a las siguientes URLs según el ambiente:

Producción: https://api.bamboopayment.com/v2/api/Reporting/billing-movements
Stage: https://api.stage.bamboopayment.com/v2/api/Reporting/billing-movements

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 la solicitud (Request)

Campo	Tipo	Obligatorio	Descripción
`ReferenceId`	string	Sí	Un identificador único para esta solicitud de retiro
`CurrencyIsoCode`	string	Sí	El código ISO de la moneda para el retiro (por ejemplo, “USD”)
`Requester`	string	No	Identificador de la persona o sistema que solicita el retiro
`TextNotes`	string	No	Notas o comentarios adicionales sobre el retiro

Ejemplo de solicitud

{
  "ReferenceId": "retiro-001",
  "CurrencyIsoCode": "USD",
  "Requester": "comerciante-001",
  "TextNotes": "Retiro para gastos operativos mensuales"
}

Parámetros de la Respuesta (Response)

Note

Al consultar datos recientes, tenga en cuenta que la información más actualizada disponible podría ser del día anterior (D-1). Esto implica que los datos más recientes disponibles a través de la API podrían ser del día anterior a la fecha actual. Tenga esto en cuenta al consultar transacciones recientes.

Propiedad	Tipo	Descripción
`Data`	`Array`	Array de objetos por cada movimiento de cuenta
`Data` → `transactionid`	`String`	ID de transacción asociado con este movimiento financiero
`Data` → `movementid`	`Integer`	Identificador del movimiento financiero
`Data` → `created`	`String`	Fecha y hora en que se creó el movimiento financiero
`Data` → `type`	`String`	Tipo de transacción (Ejemplo: `Refund`, `Purchase`, `Payout"` , `Fee`, `FX`, `Withdrawal`, `Debit adjustment`, `Credit adjustment`.)
`Data` → `country`	`String`	Código del país donde ocurrió la transacción `formato ISO 3166-1 alpha-2`
`Data` → `currency`	`String`	Código de moneda utilizado en la transacción
`Data` → `sign`	`String`	Indica si el monto es un crédito o un débito
`Data` → `amount`	`Integer`	Valor de la transacción
`Data` → `availabledate`	`String`	Fecha en que los fondos estarán disponibles
`Data` → `referenceid`	`String`	ID de referencia
`Data` → `endusernotes`	`String`	Notas asociadas con la transacción
`Data` → `exchangerate`	`Number`	Tasa de cambio utilizada (si aplica)
`Data` → `status`	`String`	Estado actual de la transacción
`Data` → `merchant_account_id`	`Integer`	ID de la cuenta
`Data` → `merchant_account_name`	`String`	Nombre de la cuenta
`Data` → `merchant_id`	`Integer`	ID del comercio
`Data` → `merchant_name`	`String`	Nombre del comercio
`Data` → `payment_method`	`String`	Medio de pago utilizado
`Data` → `payment_media_brand`	`String`	Marca del método de pago (si aplica)
`Data` → `last_status_date`	`String`	Fecha de la última actualización de estado
`Page`	`Integer`	Número de página actual
`PageSize`	`Integer`	Número de registros por página
`Total`	`Integer`	Número total de registros que coinciden con la consulta
`Errors`	`Array`	Array de mensajes de error si ocurrieron durante el procesamiento de la solicitud

Ejemplo del Response

{
  "Response": {
    "Data": [
      {
        "TransactionId": 17041776,
        "Type": "Refund",
        "Created": "2024-08-12T13:44:18.397",
        "Status": "Confirmed",
        "Amount": -1,
        "Currency": "USD",
        "Country": "PE",
        "Transaction_source": "BankTransfer",
        "Tenant": "Global Retail Group",
        "Merchant_account": "ACME Online Store",
        "Payment_method_type": "BankTransfer",
        "Payment_method": null,
        "Card_bin": null,
        "Card_last4": null,
        "Order": "REF123456",
        "Unique_id": null,
        "Authorization_code": null,
        "Installments": 1,
        "Issuer": null,
        "Customer_name": null,
        "Customer_document_type": null,
        "Customer_document_number": null,
        "Customer_email": null
      }
    ],
    "Page": 1,
    "PageSize": 10,
    "Total": 1
  },
  "Errors": []
}

Última modificación 20 de diciembre de 2024