Del pedido al reembolso
Orders · compatibilidad Mercado Pago
Creación, transacciones, procesamiento, captura, cancelación y reembolso en el perfil Plaza.
- Crear
- Procesar
- Capturar
- Reembolsar
TU SANDBOX. TUS REGLAS.
Pagos de prueba.
Posibilidades
reales.
Tu laboratorio local para integrar pagos con Vector, Harbor y Plaza, perfiles propios compatibles con flujos seleccionados de Stripe, PayPal y Mercado Pago.
Sin depender del sandbox de un proveedor.
ENTORNO LOCALListo para experimentar
POST → 200Vista ilustrativa · sin dinero real
Sin credenciales realesSin tarjetas realesSin dinero realEjecución local
PERFILES DE COMPATIBILIDAD
Tres identidades propias. Un entorno que controlas.
Vector, Harbor y Plaza exponen vocabularios compatibles con flujos seleccionados de proveedores conocidos, sin adoptar sus marcas como identidad del producto.
Control sobre la captura
PaymentIntents · Refunds · compatibilidad Stripe
Create/confirm, captura manual y reembolsos con formas wire compatibles con Stripe.
- Crear
- Confirmar
- Capturar
- Reembolsar
Aprobación incluida
Orders v2 · Payments v2 · compatibilidad PayPal
OAuth local, aprobación, autorización, captura, anulación y reembolso en el perfil Harbor.
- Crear
- Aprobar
- Capturar
- Reembolsar
Flujos seleccionados, no catálogos completos. Consulta los informes de fidelidad para conocer la cobertura y sus límites.
CÓMO FUNCIONA
Cambia el destino. Conserva tu integración.
Registra una aplicación, configura sus credenciales locales y apunta tu integración al emulador. Cada petición recorre un flujo observable.
Explorar la arquitecturaPetición
HTTP → Contrato → Resultado- Tu aplicaciónEnvía la petición
- Emulator APIValida el contrato
- Emulador de proveedorTraduce la operación
- Banco falso + ledgerRegistra el movimiento
- WebhookNotifica el resultado
- Tu aplicaciónProcesa el evento
Un recorrido compartido. El contrato de cada proveedor en los extremos.
ESCENARIOS DETERMINISTAS
El caso difícil. A un cambio de escenario.
Un pago aprobado, un rechazo o una acción pendiente. Elige el resultado para reproducir el caso que necesitas depurar, una y otra vez.
Mismo escenario. Mismo resultado.
Asigna el escenario a tu aplicación o usa X-Emulator-Scenario por petición.
Diseñar escenariosescenario de creación
Contrato
payment.createWebhook habilitadovector/payment-approved.json
{
"provider": "vector",
"version": 1,
"when": {
"operation": "payment.create"
},
"then": {
"outcome": "captured",
"webhook": {
"enabled": true,
"delayMs": 50
}
}
}Resultado canónico
capturedEjemplo interactivo · no envía peticiones
Traza ilustrativa
trace_demoUna petición. Su historial completo.
- Entrada
request.received - Validación
contract.validated - Escenario
scenario.matched - Respuesta
response.sent
Entrega de webhook
Worker · firma · reintentos · historial
WEBHOOKS + TRAZAS
Sigue el pago. Entiende el porqué.
Inspecciona qué contrato se validó y qué escenario coincidió. Consulta las entregas y reintentos de webhook, y relaciona la petición con tus logs mediante su correlation ID.
BANCO FALSO. CONTABILIDAD REALISTA.
Cada movimiento tiene su contrapartida.
Los pagos no son estados mágicos. El banco falso registra asientos de partida doble para seguir capturas, comisiones, reservas, liquidaciones y reembolsos.
Saldos derivados de los movimientos. Importes en unidades menores. Ningún dinero real.
Conocer el banco falsoDiferencia entre debe y haber0,00 USDUna moneda · partida doble
| Cuenta | Debe | Haber |
|---|---|---|
| Caja del sistema | 100,00 USD | — |
| Fondos en tránsito | — | 100,00 USD |
Debe = haber
UN LABORATORIO, TRES SUPERFICIES
Integra. Simula. Inspecciona.
Tres aplicaciones separadas, conectadas mediante la API.
Petición
POST /v1/payment_intents{
"amount": 10000,
"currency": "usd",
"confirm": true
}API
Para tu integraciónContratos de proveedor, escenarios y operaciones de pago sobre NestJS.
Contratos y APIAplicacionesPagos
demo-storeVectorpayment_demoCapturadoConsole
Para quien desarrollaAplicaciones, credenciales locales, pagos, ledger, webhooks y trazas.
Abrir la consolaTarjeta de prueba100,00 USDPago simulado
•••• 4242Checkout
Para quien pagaPrueba la experiencia de compra con la identidad propia y el flujo de cada perfil del emulador.
Explorar el checkoutDEL REPOSITORIO A TU PRIMER PAGO
Tu próximo sandbox vive en tu máquina.
Clona el repositorio y ejecuta el instalador. Comprueba Node, prepara el entorno, instala, compila, migra y crea tu administrador.
Guía de instalaciónTerminal · raíz del repositorio
npm run setupLo que prepara el instalador
- 01Versión de Node y entorno
- 02Dependencias y compilación
- 03Migraciones de la base de datos
- 04Cuenta de administrador
Node ≥ 22.17 · Docker Compose o PostgreSQL local
Docker deja la pila en marcha. En modo local, inicia los procesos siguiendo la guía.
- 01Clonar
- 02Preparar
- 03Ejecutar
- 04Integrar
- 05Simular
- 06Inspeccionar
DOCUMENTACIÓN SIN ATAJOS
Menos suposiciones. Más respuestas.
Guías en español e inglés, desde el primer arranque hasta los límites de cada contrato.
Ver toda la documentaciónPREGUNTAS FRECUENTES
Lo que conviene saber antes de empezar.
Respuestas cortas, con el documento que las desarrolla.
Ver toda la documentación¿Qué es Payment Emulator Lab?
Un emulador local de pasarelas de pago: una API, una consola, un checkout y un banco falso con contabilidad por partida doble. Se ejecuta entero en tu máquina.
Descripción del proyecto¿Necesito credenciales o tarjetas reales?
No. Registras tu aplicación en el emulador y él emite las credenciales locales con las que firmas cada petición. Ninguna tarjeta ni cuenta real interviene.
Primeros pasos¿Sustituye al sandbox de Stripe, PayPal o Mercado Pago?
No, y no es un producto oficial de esos proveedores. Emula flujos seleccionados con su vocabulario; los informes de fidelidad describen qué está cubierto y qué no.
Funciones y límites¿Qué flujos están soportados?
Plaza cubre Orders compatibles con Mercado Pago; Vector cubre PaymentIntents y Refunds compatibles con Stripe; Harbor cubre Orders v2 y Payments v2 compatibles con PayPal. Cada informe de fidelidad delimita el alcance.
Informe de Vector¿Puedo probar webhooks y depurar lo que ocurre?
Sí. El emulador emite los eventos de cada operación, registra sus entregas y guarda la traza de la petición que los originó.
Webhooks y trazas¿Puedo forzar un rechazo o un caso concreto?
Sí. Los escenarios deterministas asocian una condición a un resultado, de modo que el mismo caso se reproduce igual cada vez que lo necesites.
Escenarios deterministasEL SIGUIENTE PAGO ES DE PRUEBA
Deja de probar integraciones de pago con dinero y credenciales reales.
Tu código, tus escenarios y un entorno para entender cada resultado.