Validator - Pruebas en entorno de desarrollo
Prueba tu integracion usando Simulated Bank
A través del Sandbox: Simulated Bank (conectado al entorno de pruebas de Shinkansen, en https://dev.validator.shinkansen.finance) puedes probar los 3 posibles return_code del validador y el caso en que el banco no responde:
| Número de cuenta | Tipo de Cuenta | Resultado que recibirás |
|---|---|---|
99900 |
current_account, cash_account, savings_account |
❓ unable_to_validate |
999000000000000000 |
clabe |
❓ unable_to_validate |
99901 |
current_account, cash_account, savings_account |
❌ invalid_account_details (account_not_found) |
999010000000000000 |
clabe |
❌ invalid_account_details (account_not_found) |
99902 |
current_account, cash_account, savings_account |
❌ invalid_account_details (account_detail_mismatch) |
999020000000000000 |
clabe |
❌ invalid_account_details (account_detail_mismatch) |
99942 |
current_account, cash_account, savings_account |
⏳ Sin respuesta del banco: la validación se queda en pending |
999420000000000000 |
clabe |
⏳ Sin respuesta del banco: la validación se queda en pending |
| Cuenta creada en https://simulatedbank.shinkansen.tech | Tipo de cuenta indicado por SimulatedBank | ✅ valid_account_details (en México, solo si el RFC coincide) |
El motivo entre paréntesis llega en el campo invalid_account_details_reason de la respuesta.
En México Simulated Bank sí verifica el RFC
En Chile, Simulated Bank solo verifica el número de cuenta: cualquier cuenta existente en Simulated Bank generará validaciones exitosas, sin importar los datos de identidad que envíes. Por eso, para probar validaciones fallidas debes usar las cuentas indicadas más arriba.
En México, en cambio, Shinkansen compara la identificación que envías en la solicitud con la del titular de la cuenta CLABE en Simulated Bank (la que aparece en el bloque Shinkansen debtor/creditor de la cuenta). Si coincide, recibirás valid_account_details; si no, recibirás invalid_account_details con account_detail_mismatch.
Docs detallados de APIs relacionadas
Crear una validación
POST /v1/validation/requests/
Recibir resultado de validacion (webhook, recomendado)
POST /from/shinkansen/to/your/webhook/url
Obtener estado de validación (polling, no recomendado)
GET /v1/validation/requests/{id}
