# 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:

<table><thead><tr><th width="256">Estado</th><th>Descripción</th><th data-hidden>Equivalencia reporte</th></tr></thead><tbody><tr><td>SUCCESS<br><code>Exitoso</code></td><td>Cuando el pago ha sido completado/pagado.</td><td>Exitoso</td></tr><tr><td>REVIEW<br><code>Por conciliar</code></td><td>Cuando el pago está en revisión (ejemplo: pago en efectivo a un transportador) </td><td>Por conciliar</td></tr><tr><td>OVERDUE<br><code>Vencido</code></td><td>Cuando el cobro no fue completado/pagado a tiempo</td><td>Programado</td></tr><tr><td>FAILED<br><code>En proceso</code></td><td>Cuando se realizó el envío de la dispersión a la entidad del destinatario.</td><td>Pendiente</td></tr><tr><td>DECLINED<br><code>Declinada</code></td><td>Cuando el usuario rechaza un pago. </td><td>Rechazado</td></tr><tr><td>BLOCKED<br><code>Bloqueada</code></td><td>Cuando el pago ha sido bloqueado por sospecha de fraude.</td><td>Pendiente</td></tr></tbody></table>

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

{% hint style="info" %}
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.
{% endhint %}

## Encabezado

<table><thead><tr><th width="232.5999755859375">Nombre</th><th>Contenido</th></tr></thead><tbody><tr><td><code>Authorization</code></td><td>Bearer base64(client_id:client_secret_key) </td></tr><tr><td><code>Content-Type</code></td><td>application/json</td></tr></tbody></table>

## Payload

{% code overflow="wrap" %}

```json
{
    "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": "test@qentaz.com",
            "first_name": "Nombre",
            "last_name": "Apellido",
            "business_name": "",
            "user_id_type": "CC",
            "user_id_number": "1234567890"
        }
    }
}
```

{% endcode %}