Detalle de movimientos
/b2b/movements/{accountId}/{movementId}/b2b/transactions/detail
Devuelven el detalle completo de un movimiento: montos, tasa, costos, propósito y datos del
beneficiario o remitente (nombre, documento, cuenta, banco y país). Endpoints de solo lectura del servicio
business-api.
Esta guía explica cómo consultar el detalle de un movimiento una vez que ya tienes un token de acceso válido. Si todavía no sabes cómo obtenerlo, empieza por Autenticación.
Resumen
Hay dos formas de llegar al mismo detalle, según el dato con el que parta tu integración:
| Endpoint | Se consulta con | Cuándo usarlo |
|---|---|---|
GET /b2b/movements/{accountId}/{movementId}?productType= | El id del movimiento que devuelve el listado de movimientos | Partes del listado de movimientos de tu cuenta |
GET /b2b/transactions/detail?externalReferenceId= | El externalReferenceId que enviaste al crear el pago | Partes de un pago que creaste por API y quieres su detalle sin pasar por el listado |
Ambos devuelven el mismo bloque de detalle para un mismo movimiento. El movementId de la respuesta es el mismo id del listado de movimientos, así que sirve para conciliar (en el endpoint por externalReferenceId puede faltar en remesas: revisa la sección 2).
URL base y autenticación
| Ambiente | URL base |
|---|---|
| Producción | https://api.global66.com/business-api |
Los dos endpoints usan la misma credencial de API de tu empresa que ya usas para crear pagos con POST /b2b/transactions/payments. El token se obtiene con POST /b2b/auth (está explicado en Autenticación) y se envía en el header Authorization de cada request:
La IP de origen de tus llamadas debe estar en la lista de IPs permitidas de la credencial. Si no lo está, la autenticación responde 401. Revisa cómo configurarla en Credenciales.
1. Detalle por movementId
Consulta el detalle de un movimiento de una cuenta a partir del id que devuelve el listado. El accountId es el walletId que devuelve la consulta de cuentas.
/b2b/movements/{accountId}/{movementId}?productType={productType}Parámetros
123456845185REMITTANCEEjemplo de petición
Respuesta 200 OK
La forma de la respuesta es la misma para todos los productos; cambian algunos campos según el tipo de movimiento. Elige el caso que quieras ver:
Remesa de salida, con los datos completos del beneficiario.
En un P2P la contraparte es otra empresa Global66, por eso el beneficiary trae solo name y countryCode.
Mismo formato. El movementType es P2P_PAYMENT_RECEIVED y el beneficiary es la empresa que envió el pago.
Cambio de moneda entre cuentas propias.
Depósito recibido por transferencia bancaria (por ejemplo, CCA o ACH). Trae remitter en vez de beneficiary, con los datos de quien envió el dinero. origin y destination son el monto acreditado. Los P2P recibidos de otra empresa Global66 siguen siendo P2P.
En el listado, un PAYIN es el movimiento con category: "PAY_IN" y subCategory: "BANK_TRANSFER". Ese movimiento trae productType: "PAYIN", y ese es el valor que pasas al detalle.
2. Detalle por externalReferenceId
Consulta el detalle de un pago que creaste por API, usando el identificador que tú mismo enviaste al crearlo.
/b2b/transactions/detail?externalReferenceId={externalReferenceId}Parámetros
PAGO-2026-0001Ejemplo de petición
Respuesta 200 OK
La respuesta envuelve el estado del pago por API. Cuando el pago terminó, incluye dentro de detail el mismo bloque de detalle del endpoint anterior. En remesas, detail.movementId es el mismo identificador que expone el listado de movimientos; si no se logra resolver, el detalle viaja igual pero sin ese campo.
Campos del envoltorio
PAGO-2026-0001395REMITTANCECOMPLETEDEsto no es un error: el pago existe, pero todavía no generó un movimiento (o no llegó a generarlo). Por eso la respuesta no trae detail.
Referencia de campos del detalle
Los campos sin valor no se envían. Por ejemplo, amountUsd o exchangeRateText no aparecen cuando el producto no los reporta. Tu integración debe tolerar que cualquiera de ellos falte.
845185REMITTANCEDATOS_VERIFICADOSP2P_PAYMENT_SENT2026-09-15T18:39:13955.450012211 CLP = 5,29 COPPago factura 123Bloque remitter
El bloque remitter solo viene en los movimientos PAYIN. Sus datos son los que reporta el banco o el canal de ingreso; los que no vengan se omiten, así que tu integración debe tolerar que falte cualquiera de ellos.
Juan PérezRUT12345678-9000000000000123456780507Banco del DesarrolloErrores
Los errores responden con el formato { "code": "...", "reason": "...", "source": "...", "hideModalError": false }. La excepción es el 401, que responde el API Gateway con otro formato.
Para saber qué errores reintentar y cuáles no, revisa Errores y reintentos.
Siguientes pasos
Usa la consulta de movimientos para obtener el id y el productType con los que pedir cada detalle, o revisa errores y reintentos para definir cómo tu integración reacciona a cada respuesta.