# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.qentaz.com/documentation/webhooks/eventos-de-cobros.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.