Simulador de transacciones
Prueba casos de simulación sobre tarjetas reales sin afectar tu ambiente productivo.
Introducción
Antes de salir a producción, es fundamental saber que tu integración responde correctamente ante cada tipo de transacción. El Simulador de transacciones te permite ejecutar escenarios predefinidos (compras aprobadas, rechazos, transacciones internacionales y más) sobre tarjetas reales de tu cartera, de forma completamente segura y sin generar movimientos reales en las cuentas de tus usuarios.
Desde el Dashboard en Stage puedes recorrer el flujo completo: elegir el caso que quieres probar, seleccionar la tarjeta sobre la que se ejecutará, iniciar la simulación y ver el resultado paso a paso en tiempo real.
¿Para qué sirve simular?
Simular transacciones te da visibilidad y control sobre tu integración en un ambiente seguro, antes de que cualquier usuario final se vea afectado. Estos son los casos de uso más comunes:
| Uso | Descripción |
|---|---|
| Validar tu integración desde el inicio | Verifica que tu endpoint de autorización recibe correctamente nuestros mensajes, interpreta los campos esperados y responde dentro del tiempo límite. Detecta problemas de configuración sin necesidad de coordinar transacciones reales. |
| Probar escenarios específicos sin riesgo | Reproduce situaciones que en producción son difíciles de controlar: fondos insuficientes, tarjetas bloqueadas, transacciones rechazadas por la red, transacciones internacionales. Cada caso simula el comportamiento real del flujo de autorización. |
| Homologar tu implementación | Confirma que tu sistema procesa cada tipo de transacción según lo acordado. El simulador es la herramienta de referencia para validar que tu integración está lista antes del go-live. |
| Detectar errores antes de que lleguen a producción | Cada simulación devuelve el resultado paso a paso. Si algo falla, puedes identificar exactamente en qué punto del flujo ocurrió el error y corregirlo sin impactar a ningún usuario real. |
| Regresar al simulador cuando actualices tu integración | Cuando realizas cambios en tu backend, puedes volver a ejecutar los casos de simulación para asegurarte de que nada se rompió. Funciona como un conjunto de pruebas de regresión accesibles desde el Dashboard. |
Alcance
| Marca | Productos | Tipos de tarjeta |
|---|---|---|
| Visa | Crédito, Débito, Prepago | Física, Virtual |
| Mastercard | Crédito, Débito, Prepago | Física, Virtual |
Cada caso de simulación especifica con qué combinación de marca, producto y tipo de tarjeta es compatible. Solo verás las tarjetas de tu cartera que cumplan con esas condiciones al momento de ejecutar.
¿Quién puede usar el simulador?
El simulador está disponible para todos nuestros clientes. Para usarlo, deberás tener:
- Al menos una tarjeta activa.
- Un endpoint de autorización configurado con nuestro equipo de integradores.
Flujo de simulación
El simulador se recorre en cuatro pasos, siempre en el mismo orden:
- Elegir el caso: selecciona el escenario que quieres probar desde el listado.
- Consultar el detalle (opcional): revisa los pasos del caso y sus características antes de simular.
- Seleccionar la tarjeta: elige sobre qué tarjeta ejecutaremos la simulación.
- Ver el resultado: ejecutamos el caso y mostramos el resultado paso a paso.
Resultado exitoso
Cuando todos los pasos se completan correctamente, verás el resumen de la simulación:
- Tarjeta usada: marca, producto, tipo, estado y últimos 4 dígitos.
- Caso ejecutado: nombre del caso simulado.
- Respuesta de la simulación:
| Campo | Descripción |
|---|---|
| ID de simulación | Identificador único de la ejecución. |
| ID de autorización | Identificador de la autorización generada. |
| Estado | Resultado de la transacción: Aprobada o Rechazada. |
Desde esta pantalla puedes:
- Ver transacción: accede directamente al detalle de la transacción generada en el Dashboard.
- Simular otro caso: vuelve al listado de casos para iniciar una nueva simulación.
Error en la simulación
Si un paso falla durante la ejecución, el simulador muestra un aviso con el nombre y la descripción del error. Los pasos anteriores al error conservan su estado "Completado" y los siguientes quedan en "Pendiente".
Preguntas frecuentes
¿Las simulaciones afectan las tarjetas reales de mis usuarios?
No. Todas las simulaciones se ejecutan en nuestro ambiente de Stage y no generan movimientos reales ni afectan a tus usuarios finales.
¿Por qué no veo ningún caso en el listado?
Puede deberse a dos razones: que tu endpoint de autorización no esté configurado, o que no haya casos disponibles para tu cuenta en este momento. Si el endpoint no está configurado, verás un aviso específico en el Dashboard. Ante cualquier duda, ponte en contacto con nosotros.
¿Por qué el botón "Simular este caso" aparece deshabilitado?
Significa que no tienes tarjetas en tu cartera que sean compatibles con el caso elegido (por marca, tipo de producto o tipo de tarjeta). Puedes crear una tarjeta compatible vía API.
¿Puedo simular con una tarjeta bloqueada o expirada?
Sí. El listado de tarjetas incluye tarjetas en estado ACTIVE, BLOCKED y EXPIRED. El estado de la tarjeta forma parte del escenario simulado y puede influir en el resultado.
¿Qué significa el botón "Endpoint configurado" en el encabezado?
Indica que tu endpoint de autorización está activo. Al hacer clic, se abre la URL del endpoint en una nueva pestaña.