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:

  1. Visita https://simulatedbank.shinkansen.tech/ y regístrate. Te recomendamos usar una cuenta google de tu empresa en el login.

  2. 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 😅

  3. 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.

  4. 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 endpoint dev.shinkansen.finance, nuestro switch va a mandar la solicitud al Simulated Bank.

  5. 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 😉)

  6. 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:
      • 99900error
      • 99901error_creditor_account_not_found
      • 99902error_creditor_account_detail_mismatch
      • 99903error_creditor_account_over_limits
      • 99904error_creditor_fi_offline
      • 99905error_payment_rail_offline
      • 99906error_debtor_account_over_limits
      • 99907error_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.