> For the complete documentation index, see [llms.txt](https://docs.payvalida.com/api-cashout/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payvalida.com/api-cashout/notificacion/notificacion.md).

# Notificación

{% hint style="info" %}
Para esta etapa del proceso de integración el comercio debe construir un servicio REST que será consumido por Payválida para realizar el proceso de notificación. Cuando esté construido, se debe comunicar a Payválida para que se realice el registro de la URL de dicho servicio. 
{% endhint %}

Al momento de registrar una orden de desembolso, ésta se crea en estado **PENDIENTE**. La orden de desembolso puede cambiar por diversas razones: 

1. El cliente ha efectuado el desembolso -> Cambia de estado **PENDIENTE**  a **APROBADO** y se notifica con status **APROBADA**.
2. No se ha efectuado el desembolso antes de la fecha de vencimiento -> Cambia de estado **PENDIENTE** a **CANCELADA** y se notifica con status **VENCIDA**. 

El sistema notifica de forma automática en el momento del cambio de estado de la orden.

La notificación se envía por el método HTTP **POST** con un body de tipo **json**.

{% tabs %}
{% tab title="Request (Lo ejecuta Payvalida)" %}

| Campo          | Tipo    | Descripción                                                                                                                                                                            |
| -------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| amount         | float64 | Monto de la orden de desembolso                                                                                                                                                        |
| document       | string  | Documento de identidad asociado a la orden de desembolso                                                                                                                               |
| operation      | string  | Identificador generado por el comercio para la orden de desembolso                                                                                                                     |
| currency       | string  | Moneda con la que se registra la orden de desembolso                                                                                                                                   |
| status         | string  | Estado de la orden del desembolso (El valor que se envía es APROBADA)                                                                                                                  |
| checksum       | string  | Cadena de comprobación calculada con SHA512(operation+document+amount+currency+status+NOTIFICATION\_HASH). El amount para el cálculo del checksum debe ser transformado a entero.      |
| location\_code | string  | <p>Información código de localización, en Colombia se envía el código dane de la operación.<br>Para los demás países, se envía el location\_code que proveen las redes de recaudo.</p> |

{% endtab %}

{% tab title="Response" %}

| Campo         | Tipo   | Descripción                                                                                               |
| ------------- | ------ | --------------------------------------------------------------------------------------------------------- |
| code          | int    | El valor 0 lo tomamos como ejecución correcta. Si se retorna un valor diferente lo tomamos como un error. |
| text          | string | Descripción de la ejecución al momento de responder.                                                      |
| {% endtab %}  |        |                                                                                                           |
| {% endtabs %} |        |                                                                                                           |