Payouts: Integridad y Tiempos de Espera

Cuando movemos dinero la integridad/consistencia es clave. No queremos tener en un lado la idea de que una transacción falló y en el otro extremo creer que tuvo éxito.

Por eso es clave que todos sepamos quien y cuando determina que una transacción tuvo éxito. Y cuando los otros actores nos enteramos de ese resultado.

¿Quien determina si un payout tiene éxito?

• El PO es el único actor que puede determinar el ✅ éxito o ❌ fallo de una transacción que fue recibida por el PO.
  • Excepcionalmente, Shinkansen podrá determinar el ❌ fallo de una transacción si el PO no puede recibir la instrucción debido a alguna intermitencia prolongada.

¿Cuánto toma el flujo de un payout en ejecutarse?

• Típicamente segundos, según la velocidad de procesamiento del PO (operador de payouts, típicamente el banco desde donde salen los fondos).
  • Pero podría tomar minutos en casos excepcionales (ej: institucion financiera de destino del pago con problemas para aceptarlo).
  • En casos extremadamente excepcionales, podría tomar más de 5 minutos (ej: PO offline después de haber recibido la instrucción de payout).

👍

En la práctica:

Recibirás una respuesta de una transacción de payout en segundos o pocos minutos la mayoría de las veces. Pero debes estar preparado para que algunas transacciones demoren 10-20x más tiempo o incluso que alguna transacción quede pendiente por un tiempo aún mayor. En estos casos excepcionales debes esperar que el actor que está fuera de línea pueda enviar la respuesta (sea el PO, el riel de pagos, la institución financiera destino). Si no esperas, corres el riesgo de asumir que un pago no se realizó cuando sí alcanzó a ser ejecutado antes que ocurriera la intermitencia (o viceversa).

Manejo de errores y tiempos de respuesta

Este diagrama muestra gráficamente el manejo de errores y los tiempos esperados en cada paso: