Payouts - Probar casos de error
Más allá del caso feliz
Casos de error en entorno dev de Shinkansen
En el entorno dev de Shinkansen puedes enviar transacciones hacia números de cuenta de bancos reales. La transacción obviamente no se ejecuta, pero la respuesta que recibirás en tu webhook de respuestas simulará una transacción exitosa.
Para simular payouts con casos especiales, puedes usar nuestro banco ficticio, llamado Simulated Bank. Para eso:
-
Visita https://simulatedbank.shinkansen.tech/ y regístrate. Te recomendamos usar una cuenta google de tu empresa en el login.
-
Visita la sección de Organizaciones en https://simulatedbank.shinkansen.tech/app/orgs y crea una nueva organización que representará a tu empresa en el banco ficticio. Es súper importante que pongas el id de Shinkansen asignado a tu empresa (el mismo que envías en el campo
header.sender.fin_id
de tus mensajes)Tip: Lo ideal es que pongas también el certificado publico correcto
...pero si no lo tienes a mano puedes superar la validacion escribiendo algo muuuuy largo 😅
-
Luego vas a la pagina de la organización y encontrarás que tienes cuentas bancarias falsas para distintos países. Escoge la que corresponda al país donde estás haciendo pruebas.
-
Ahí te aparecerán los datos que deberás usar en el entorno de prueba en el campo
debtor
de tus transacciones de payout. Cuando uses esos datos como cuenta de origen y uses el endpointdev.shinkansen.finance
, nuestro switch va a mandar la solicitud al Simulated Bank. -
Presiona el botón que te permite depositar plata. Ingresa un monto razonable que te permita hacer algunas pruebas (a menos que quieras partir probando el error de falta de fondos 😉)
-
Para hacer pruebas tienes los siguientes casos:
- Transferir a un destinatario (creditor) en el banco con id
SIMULATED_BANK
. En ese caso:- Te saldrá error de cuenta inexistente si usas una cuenta que no ha sido creada en el banco simulado
- Funcionará ok si usas una cuenta correcta (si vas a tu dashboard personal, encontrarás un numero de cuenta falso a título personal que puedes usar como cuenta de destino en una prueba exitosa)
- Transferir a un destinatario (creditor) en cualquier otro banco. Acá funcionará todo, excepto cuando el destino (creditor) sea cualquiera de estos numeros de cuenta:
99900
→error
99901
→error_creditor_account_not_found
99902
→error_creditor_account_detail_mismatch
99903
→error_creditor_account_over_limits
99904
→error_creditor_fi_offline
99905
→error_payment_rail_offline
99906
→error_debtor_account_over_limits
99907
→error_debtor_insufficient_funds
99942
→ No habrá respuesta del banco. Usado por Shinkansen para protocolos de timeout, pero puedes usarlo también en caso que desarrolles alertas después de X tiempo sin tener una respuesta del banco.
- Nota que cualquier otro escenario será reportado como exitoso.
Para pruebas de pagos en MXN no se indica el identificador del banco
En México usamos la CLABE como número de cuenta para transferir. Este número ya incluye el identificador del banco en sus primeros tres dígitos.
En el ambiente dev, asumimos que cualquier cuenta que comience con 999 es una cuenta de Simulated Bank.
Por lo tanto, cualquier transferencia en el ambiente de pruebas a una cuenta CLABE que no comience con "999" será reportada exitosa.
- Transferir a un destinatario (creditor) en el banco con id
Updated 11 months ago