Sandbox
El sandbox es el mismo API contra el banco simulado de FINORA (BANCO_SIM). No hay claves distintas ni otro host: marcas "sandbox": true al crear la sesión (o el cobro en FINORA Pago) para que la página y el webhook lo digan, y el desenlace lo deciden los céntimos del monto y los datos del pagador.
Montos
| Céntimos del monto | Desenlace | codigo |
|---|---|---|
.51 | RECHAZADA Fondos insuficientes | 51 |
.05 | RECHAZADA No honrar | 05 |
.61 | RECHAZADA Excede el límite | 61 |
.96 | EN_DUDA (el banco responde tarde); el barrido la resuelve APROBADA y llega un segundo webhook | 96 |
.91 | EN_DUDA (503, el banco no la registró); se resuelve RECHAZADA | 91 |
| cualquier otro | APROBADA | 00 |
Ejemplo: 227.00 aprueba, 227.51 rechaza, 227.96 queda en duda y se aprueba después.
Datos del pagador
| Riel | Condición | Desenlace |
|---|---|---|
| Pago móvil | teléfono fuera de 0(412|414|416|424|426) + 7 dígitos | 14 Teléfono inválido |
| Pago móvil | teléfono termina en 0000 | 57 No afiliado |
| Transferencia | cuenta distinta de 20 dígitos / termina en 0000 | 14 / 62 |
| Cripto | wallet fuera de 20–64 alfanuméricos | 14 |
Tarjeta en el terminal
Para tarjeta hace falta un terminal físico con AuroraPOS (o el emulador ECR) apuntando al banco simulado, BIN 400000. En este comercio: los terminales de prueba que FINORA asigne a tu comercio.
| PAN termina en | Desenlace |
|---|---|
5100 | 51 Fondos insuficientes |
1732 | 43 Tarjeta retenida |
0018 | 54 Tarjeta vencida |
5156 | 41 Tarjeta extraviada |
9999 | Sin respuesta → EN_DUDA |
| cualquier otro | APROBADA |
Tarjetas de certificación del core (modo core): 5555 5555 5555 4444 aprueba, 5105 5105 5105 5100 responde 51, 5424 … responde 43.
Qué más se puede provocar
- El terminal no toma la orden: la sesión vuelve a
CREADAconcodigo = TERMINAL_SIN_RESPUESTAy el checkout muestra otra vez el selector de medios. En el Merchant real pasa cuando el TTL del despacho vence sin que el terminal acepte. - Webhook que falla: apunta
webhookUrla un endpoint que responda500y verás la entregaPENDIENTEcon sus reintentos en Webhooks. - Sesión expirada:
ttlSegundos: 60y espera.
Códigos de respuesta del banco (DE 39)
| Código | Significado | Estado de la sesión |
|---|---|---|
00 | Aprobada | APROBADA |
05 | No honrar | RECHAZADA |
14 | Teléfono / cuenta / wallet inválidos | RECHAZADA |
41 / 43 / 54 | Tarjeta extraviada / retenida / vencida | RECHAZADA |
51 | Fondos insuficientes | RECHAZADA |
57 | No afiliado a pago móvil | RECHAZADA |
58 | Terminal suspendido | RECHAZADA |
61 | Excede el límite | RECHAZADA |
62 | Cuenta o referencia no encontrada | RECHAZADA |
91 | El banco no registró la operación | EN_DUDA → RECHAZADA |
96 | El banco respondió tarde | EN_DUDA → APROBADA |
Un rechazo es final: crea otra sesión si el cliente quiere intentar con otro medio. La consola de pruebas crea sesiones sandbox con tu clave y sigue el estado en vivo.