Confimar Pago
Visión General
Este endpoint permite confirmar y enviar un pago previamente creado a través de la infraestructura Bre-B. Una vez confirmado, el pago se procesa en el sistema financiero correspondiente.
Detalles del Endpoint
Parámetro | Descripción |
---|---|
Endpoint | https://bre-b-sandbox.api.visionamos.passportfintech.com/v1/paas/entities/customers/payments/breb/confirm |
Método | POST |
Encabezados | Content-Type: application/json, Authorization |
Autenticación | Token de Acceso (Bearer Token) |
Cuerpo de la Solicitud
Parámetro | Tipo | Descripción |
---|---|---|
id | String | Identificador único del pago que se desea confirmar. |
Ejemplo de Solicitud
6
curl --location 'https://bre-b-sandbox.api.visionamos.passportfintech.com/v1/paas/entities/customers/breb/payments/confirm' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer TU_TOKEN_DE_ACCESO' \
--data '{
"id": "cdb5ae4b-fd6e-4244-9e16-a4e6262f0fe2"
}'
Cuerpo de la Respuesta
- Código HTTP: 200 OK
- Retorna los datos del pago y el estado.
Ejemplo de Respuesta
11
11
{
"status": "SETTLED",
"reference": "Test payment",
"account_id": "ca3fe9c0-7ddd-455d-92c1-4c749d22c0ee",
"breb_recipient_id": "4cec2308-9610-48d7-abdb-368a5f1e46b0",
"amount": {
"currency": "COP",
"value": "100000"
},
"id": "cdb5ae4b-fd6e-4244-9e16-a4e6262f0fe2"
}
Errores Comunes y Manejo
Código HTTP | Significado | Descripción |
---|---|---|
400 Bad Request | Datos inválidos | Faltan campos requeridos o contienen valores incorrectos. |
401 Unauthorized | Token inválido | El token de acceso ha expirado o es inválido. |
403 Forbidden | Acceso denegado | La solicitud no está autorizada para confirmar el pago. |
500 Server Error | Error del servidor | Se produjo un error inesperado al confirmar el pago. |
Buenas Prácticas
- Asegúrate de que el campo
id
corresponde a un pago válido creado previamente con el endpoint de Iniciar un Pago. - Monitorea el estado del pago (
PENDING
,SETTLED
, etc.) después de confirmar la transacción.