# Proceso Notificación

### <mark style="color:blue;">Notificaciones de Depósitos</mark> <a href="#deposit-status-notifications" id="deposit-status-notifications"></a>

enviado cada vez que un depósito cambia su estado, le enviaremos una notificación asíncrona a la `notification_url` que haya enviado en la llamada o la que haya configurado bajo la sección Settings -> API Access -> Confirm URL, conteniendo el identificador del depósito.

<figure><img src="https://2298703647-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGjMKy3VezYlJlCCcjySW%2Fuploads%2FdBTaiq7umpM32xwqpats%2Fimage.png?alt=media&#x26;token=32834472-c998-4872-aaab-3767b70625de" alt=""><figcaption></figcaption></figure>

**Una vez recibida la notificación, debes consultar el nuevo estado con el** [**Endpoint de Estado de Depósito**](https://docs.tupayonline.com/documentacion-de-la-api/tu-multipay/endpoint-estado) **y actualizarlo en su extremo.**

{% hint style="info" %}
Ten en cuenta que nos conectaremos solo a través de los puertos 80 y 443.\
Asegúrese que su `notification_url` tenga uno de esos puertos abiertos y aceptando conexiones nuestras.
{% endhint %}

### <mark style="color:blue;">Ambiente Staging de pruebas para las notificaciones</mark> <a href="#stg-testing" id="stg-testing"></a>

En el ambiente de STG tienen la posibilidad de probar el flujo completo tras completar o cancelar el estado de los depósitos de manera manual. Ingresando al STG Tupay Panel, yendo a Transactions -> Deposits. **Luego de cambiar el estado del depósito, enviaremos la notificación correspondiente a su `notification_url` después de unos minutos.**

<div><figure><img src="https://content.gitbook.com/content/GjMKy3VezYlJlCCcjySW/blobs/efCofpWzEO1tm9cfBtxP/Cancel%20deposits.png" alt=""><figcaption><p>Aprobar/Cancelar desde la sección de Depósitos. <span data-gb-custom-inline data-tag="emoji" data-code="1f60e">😎</span></p></figcaption></figure> <figure><img src="https://content.gitbook.com/content/GjMKy3VezYlJlCCcjySW/blobs/6G9Kd4kpu9Ry7JcF6BI1/Frame%206.png" alt=""><figcaption><p>También puedes Aprobar/Cancelar depósitos desde el detalle de la transacción.</p></figcaption></figure></div>

### <mark style="color:blue;">Respuesta de la notificación</mark> <a href="#notifications-fields" id="notifications-fields"></a>

```
{
"deposit_id": 3000000001
}​
```

<table><thead><tr><th width="158.33333333333331">Campo</th><th width="111">Formato</th><th>Descripción</th></tr></thead><tbody><tr><td>deposit_id</td><td>Number</td><td>Identificador del depósito.<br>Úselo para consultar el estado del Depósito.​</td></tr></tbody></table>

### <mark style="color:blue;">Lógica de Reintentos y Reenvío de Notificaciones</mark>

{% tabs %}
{% tab title="Lógica de reintento" %}
Cada vez que un depósito cambia su estado, le enviaremos una notificación para que pueda [consultar su nuevo estado](https://docs.tupayonline.com/documentacion-de-la-api/tu-multipay/endpoint-estado).

\
En caso de que por algún motivo su servidor no haya podido recibir la notificación y se nos haya devuelto un código HTTP distinto a 2XX, reintentaremos el envío de la notificación hasta 5 veces más o hasta que se nos responda con HTTP 2XX, lo que suceda primero.

{% hint style="info" %}
En caso de que por algún motivo su servidor no haya podido recibir la notificación, asegúrese de responder con un código HTTP distinto de 2XX, así reintentamos el envío.
{% endhint %}

El tiempo entre cada uno de los 5 reintentos de notificación es exponencial: 5, 25, 125 y 625 minutos, en ese orden.

\
Cuando el envío de una notificación falla, se verá de la siguiente manera en el Tupay Panel:

<figure><img src="https://2476386583-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M792I7hN0PzC-Sx95CP%2F-M9WWikD8y9ipNcz8Cq5%2F-M9_UqvQBGblaqYL1-oD%2Fimage.png?alt=media&#x26;token=a4343fd9-589b-4e31-bfc8-850daf84e58b" alt=""><figcaption></figcaption></figure>

Si usted ve errores como en la captura de pantalla superior, significa que el depósito fue completado con éxito, el dinero acredita en el balance de su cuenta, pero estamos recibiendo errores a la hora de notificar.
{% endtab %}

{% tab title="Reenvío de Notificaciones" %}
En caso de que no haya podido recibir ninguno de los 5 reintentos de notificación, siempre puede [volver a consultar el estado del Depósito.​](https://docs.tupayonline.com/documentacion-de-la-api/tu-multipay/endpoint-estado)

Si usted necesita ejecutar este consulta de estado a partir de nuestra notificación, una vez que haya resuelto el problema en la recepción de las notifcaciones, puede ir al Tupay Panel, localizar el Depósito (Transactions -> Deposits) y hacer click en el botón con tres puntos bajo la sección "Status History" y clickear en "Resend notification" para forzar el reenvío de una nueva notificación.

{% hint style="success" %}
Puede tomar hasta 1 minuto en que se vuelva a enviar la notificación.
{% endhint %}

<figure><img src="https://2476386583-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M792I7hN0PzC-Sx95CP%2F-M9zSa_quB7AK0C4EfRV%2F-M9zU27QNwGCCPG-JJEq%2Fimage.png?alt=media&#x26;token=3a420e35-11b0-4e22-9110-61a72568f557" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}
