# Términos de relevancia

## Tipos de dispersión 

1. **Dispersion normal:** Este método genera una dispersión que se completará según los tiempos estimados para una transferencia de acuerdo a los ciclos ACH. `type: normal`. 
2. **Dispersion inmediata:** Este método genera una dispersión que se procesará de forma inmediata, es decir, que se completará a mas tardar en una hora después de confirmada. `type: instant`.
3. **Dispersion programada:** Programa dispersiones que deben realizarse en fechas posteriores a la actual. El valor se descontará de tu saldo. En caso de anulación, se reintegrará el saldo a tu cuenta. `type: scheduled`.

{% hint style="info" %}
Las dispersiones tardan entre dos y tres ciclos ACH en reflejarse en la entidad bancaria del receptor, y entre cuatro y cinco ciclos en recibir la confirmación de la entidad receptora. Se recomienda que se realicen antes de las 12:30 PM para ser recibidas el mismo día hábil; de lo contrario, serán recibidas el siguiente día hábil.
{% endhint %}

<figure><img src="/files/1CvVITfCKspS1jbAyVwQ" alt=""><figcaption></figcaption></figure>

***

## Tipos de canales

Las dispersiones cuentan con tres canales de comunicación que puede ser usados según la necesidad del comercio:

* **Notificación por WhatsApp**: envía una notificación de la dispersión a tus usuarios por medio de WhatsApp. El usuario recibirá los detalles y un comprobante para hacer el seguimiento a la misma. `channel: whatsapp`
* **Notificación por correo**: notifica a tus usuarios de la dispersión por medio de correo electrónico. El usuario recibirá los detalles y un comprobante adjunto con los que podrá hacer el seguimiento a la misma. `channel: email`
* **Sin notificación**: el usuario no recibirá ninguna notificación. `channel: none`

{% hint style="info" %}
El destinatario puede recibir un mensaje inicial y/o final según las notificaciones definidas en el acuerdo comercial y la configuración de la cuenta.
{% endhint %}

***

## Tipos de autorización

Las dispersiones deben autorizarse según el método vigente al momento de su generación. Si están programadas, la autorización se realizará al activarse la dispersión. Es fundamental ser cuidadoso con la autorización utilizada, ya que un manejo incorrecto puede comprometer la seguridad de las dispersiones y su dinero.

* **Autorización por mensaje**: El miembro del equipo definido recibirá un mensaje con un enlace según el canal elegido (`merchant_phone` o `merchant_email`). Este enlace llevará a una página donde deberá ingresar para autorizar la dispersión. Este usuario debe contar con el rol de administrador o coordinador para poder completar el proceso. `approval: message`
* **Autorización por OTP**: El miembro del equipo designado (que debe tener el rol de administrador o coordinador) recibirá un mensaje con un código de único uso (OTP) según el canal elegido (`merchant_phone` o `merchant_email`). Este código debe ser enviado mediante la API de confirmar dispersión. `approval: otp`
* **Autorización por token**: Al crear la dispersión, se generará un evento a través de un webhook definido al configurar la cuenta, el cual incluirá el token correspondiente para la autorización de la dispersión. Este token deberá ser utilizado para completar el proceso de autorización. Este método es ideal para integraciones automatizadas donde se necesita una verificación segura y rastreable a través de tokens únicos. `approval: token`
* **Autorización en dashboard**: No se enviará ninguna notificación y la aprobación deberá hacerse desde el dashboard en la opción Dispersiones > Aprobaciones. `approval: none`

{% hint style="warning" %}
Ten en cuenta que, al crear una dispersión, recibirás un evento (*ver* [*webhooks*](/documentation/webhooks/introduccion.md)) con la información procesada. Solo en caso de seleccionar la autorización por token, recibirás un campo adicional con dicha información.
{% endhint %}

***

## Tipos de estados

En Qentaz, disponemos de diversos estados de transacción que determinan el comportamiento de una dispersión.

<table><thead><tr><th width="246">Estado</th><th width="431">Descripción</th><th>Modificable<select><option value="ievYNOLGvrdy" label="Si" color="blue"></option><option value="Dx2B65bJR6do" label="No" color="blue"></option></select></th><th data-hidden>Equivalencia reporte</th></tr></thead><tbody><tr><td>CREATED<br><code>Creada</code></td><td>Cuando se inicia un proceso de dispersión normal o inmediata.</td><td><span data-option="ievYNOLGvrdy">Si</span></td><td>Creado</td></tr><tr><td>SCHEDULED<br><code>Programada</code></td><td>Cuando se inicia un proceso de dispersión programado para ser enviado en el futuro.</td><td><span data-option="ievYNOLGvrdy">Si</span></td><td>Programado</td></tr><tr><td>PENDING<br><code>Pendiente</code></td><td>Cuando la dispersión fue autorizada y el proceso está próximo a ejecutarse.</td><td><span data-option="Dx2B65bJR6do">No</span></td><td>Pendiente</td></tr><tr><td>PROCESSING<br><code>En proceso</code></td><td>Cuando se realizó el envío de la dispersión a la entidad del destinatario.</td><td><span data-option="Dx2B65bJR6do">No</span></td><td>Pendiente</td></tr><tr><td>VERIFYING<br><code>En confirmación</code></td><td>Cuando se estima que la dispersión debe haberse acreditado en la cuenta del destinatario pero se está esperando confirmación.</td><td><span data-option="Dx2B65bJR6do">No</span></td><td>Por conciliar</td></tr><tr><td>SUCCESS<br><code>Exitosa</code></td><td>Cuando la dispersión ha sido completada/pagada.</td><td><span data-option="Dx2B65bJR6do">No</span></td><td>Exitoso</td></tr><tr><td>CANCELED<br><code>Cancelada</code></td><td>Cuando un miembro del equipo con el rol adecuado cancela la dispersión.</td><td><span data-option="Dx2B65bJR6do">No</span></td><td>Cancelado</td></tr><tr><td>DECLINED<br><code>Declinada</code></td><td>Cuando la entidad bancaria rechaza el pago y/o el sistema no encuentra alternativas para procesarlo.</td><td><span data-option="Dx2B65bJR6do">No</span></td><td>Rechazado</td></tr><tr><td>BLOCKED<br><code>Bloqueada</code></td><td>Cuando la dispersión ha sido bloqueado por sospecha de fraude.</td><td><span data-option="Dx2B65bJR6do">No</span></td><td>Pendiente</td></tr></tbody></table>


---

# 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/dispersiones/terminos-de-relevancia.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.