Confirmar Pago

Descripción

Este endpoint permite confirmar y enviar un pago Bre-B a la red Bre-B. Una solicitud exitosa procesa el pago y devuelve los detalles de la transacción, incluyendo el estado y la información del destinatario.

Detalles del Endpoint

Definición	Descripción
Endpoint	https://api.paas-sandbox.co.passportfintech.com/v1/payments/breb/confirm
Method	POST
Headers	Content-Type: application/json, Authorization
Authentication	Access Token (Bearer Token)

Cuerpo de la Solicitud

Parameter	Type	Constraints	Required	Description
id	String		Yes	Identificador único del pago a enviar a la red Bre-B.

Ejemplo de Solicitud

JSON
    
 
curl --location 'https://api.paas-sandbox.co.passportfintech.com/v1/payments/breb/confirm' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
--data '{
    "id":"11e32036-0bf3-4c8b-b873-3bc77e0a6322"
}'
Copy

Cuerpo de la Respuesta

HTTP Status Code: 200 OK.

Ejemplo de Respuesta

JSON
    
 
{
    "amount": {
        "value": "100000",
        "currency": "COP"
    },
    "account_id": "7ece7ff4-3dd4-4c27-937e-c32903940465",
    "updated_at": "2025-09-22T15:14:38.790Z",
    "direction": "OUTGOING",
    "reference": "Dispersion a merchant ABC",
    "id": "11e32036-0bf3-4c8b-b873-3bc77e0a6322",
    "breb_recipient_id": "0f7d4398-5fbd-4889-93ed-37e4ee20534d",
    "created_at": "2025-09-22T15:14:38.790Z",
    "status": "PENDING"
}
Copy

The payment status will first be PENDING. Once the payment is processed, it will change to SETTLED. You can use the Webhooks to check the payment statuses.

Errores Comunes y Manejo

HTTP Status Code	Meaning	Description
400 Bad Request	Invalid Data	Required fields are missing or contain incorrect values.
401 Unauthorized	Expired Token	The access token is invalid or has expired.
403 Forbidden	Access Denied	The request is not authorized to create a payment.
500 Internal Server Error	Server Error	An unexpected error occurred while processing the payment.

Buenas Prácticas

Ensure the id of the document is correct before making the request.
Monitor the payment status (PENDING, SETTLED, etc.) to track progress, via the Webhooks.
Implement error handling to manage failed or delayed payments.

Última actualización el