Términos de relevancia

Aquí encontrarás una explicación más detallada de los conceptos que te ayudarán a comprender mejor la documentación.

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.

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.

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

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.

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

Ten en cuenta que, al crear una dispersión, recibirás un evento (ver webhooks) con la información procesada. Solo en caso de seleccionar la autorización por token, recibirás un campo adicional con dicha información.

Tipos de estados

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

Estado
Descripción
Modificable

CREATED Creada

Cuando se inicia un proceso de dispersión normal o inmediata.

Si

SCHEDULED Programada

Cuando se inicia un proceso de dispersión programado para ser enviado en el futuro.

Si

PENDING Pendiente

Cuando la dispersión fue autorizada y el proceso está próximo a ejecutarse.

No

PROCESSING En proceso

Cuando se realizó el envío de la dispersión a la entidad del destinatario.

No

VERIFYING En confirmación

Cuando se estima que la dispersión debe haberse acreditado en la cuenta del destinatario pero se está esperando confirmación.

No

SUCCESS Exitosa

Cuando la dispersión ha sido completada/pagada.

No

CANCELED Cancelada

Cuando un miembro del equipo con el rol adecuado cancela la dispersión.

No

DECLINED Declinada

Cuando la entidad bancaria rechaza el pago y/o el sistema no encuentra alternativas para procesarlo.

No

BLOCKED Bloqueada

Cuando la dispersión ha sido bloqueado por sospecha de fraude.

No

Última actualización