Eventos de cobros

En estos eventos, te notificaremos cada vez que ocurra algún cambio de estado en tus cobros, independientemente de si estos se completan por parte del cliente o si se realizan automáticamente por el sistema. Este seguimiento detallado te permitirá estar al tanto de cada fase del proceso de cobro, brindándote la tranquilidad de no perder ninguna actualización importante referente a tus transacciones financieras. Los estados que se notifican son los siguientes:

Estado	Descripción
SUCCESS Exitoso	Cuando el pago ha sido completado/pagado.
REVIEW Por conciliar	Cuando el pago está en revisión (ejemplo: pago en efectivo a un transportador)
OVERDUE Vencido	Cuando el cobro no fue completado/pagado a tiempo
FAILED En proceso	Cuando se realizó el envío de la dispersión a la entidad del destinatario.
DECLINED Declinada	Cuando el usuario rechaza un pago.
BLOCKED Bloqueada	Cuando el pago ha sido bloqueado por sospecha de fraude.

Esto te permitirá mantener un control efectivo sobre tus cobros y reaccionar rápidamente ante cualquier eventualidad que pueda surgir.

Es importante tener en cuenta que los cobros recibidos en efectivo solo pasarán a ser exitosos en el momento en que se complete la conciliación. Cuando esto suceda, se notificará inmediatamente cada uno de los pagos en efectivo asociados a la conciliación.

Encabezado

Nombre	Contenido
Authorization	Bearer base64(client_id:client_secret_key)
Content-Type	application/json

Payload

{
    "event": {
        "type": "payment",
        "status": "success" //[success,review,overdue,failed,declined,blocked]
    },
    "created_at": "2025-03-15 16:49:02.891",
    "external_reference": "a1a2a3",
    "detail": {
        "amount": "29900",
        "currency": "COP",
        "description": "Ejemplo cobro exitoso",
        "reference_one": "REF1",
        "reference_two": "REF2",
        "reference_three": "REF3",
        "reference_four": "REF4",
        "reference_five": "REF5",
        "reference_six": "REF6",
        "reference_seven": "REF7",
        "reference_eight": "REF8",
        "channel": "WHATSAPP",
        "status": "SUCCESS",
        "merchant_phone": "573998887777",
        "merchant_email": "",
        "process_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
        "payment_method": "card",
        "payment_method_source": "amex",        
        "url_receipt": "https://content.qentaz.com/aaaabbbbccccdddd",
        "payer": {
            "phone": "573778889999",
            "email": "[email protected]",
            "first_name": "Nombre",
            "last_name": "Apellido",
            "business_name": "",
            "user_id_type": "CC",
            "user_id_number": "1234567890"
        }
    }
}