Sandbox
Prueba cada flujo en Stage. Sin mover dinero real.
Stage replica producción: el mismo contrato de API, los mismos webhooks y su propio Business Portal. Construyes y pruebas contra el mismo contrato que usarás en producción. Solo el dinero es simulado.
- Replica producción
- Tarjetas de prueba y simuladores
- Colección de Postman
Replica producciónResumen
USD
1.284.560,00
+4,2 %
BRL
3.420.118,40
+12,8 %
MXN
8.905.332,10
+6,1 %
- Pay-in · Pixorder_8F2K-1043+ R$ 1.250,00
- Payout · SPEIseller_0921− MX$ 18.400,00
- FX · BRL → USDfx_3b7q250.000,00 USD
- Pay-in · Bre-Border_9A1C-2210+ COP 890.000
Entornos
Dos entornos, una integración
Cambia de entorno modificando la URL base y las credenciales que cargas.
URL base de la API
- Stage (sandbox)
- https://api.stage.localpayment.com
- Producción
- https://api.v3.localpayment.com
Business Portal
- Stage (sandbox)
- ui.stage.localpayment.com
- Producción
- ui.v3.localpayment.com
Dinero
- Stage (sandbox)
- Simulado: no se mueven fondos reales
- Producción
- Fondos reales por rieles reales
Credenciales
- Stage (sandbox)
- Se emiten al iniciar la alianza
- Producción
- Se emiten tras las pruebas en Stage, la revisión de seguridad y el KYB
Datos
- Stage (sandbox)
- Solo datos de prueba ficticios
- Producción
- Datos reales de clientes, protegidos por tus controles y los nuestros
Lista de IP permitidas
- Stage (sandbox)
- Obligatoria
- Producción
- Obligatoria
Las credenciales de Stage y de producción son distintas. Guárdalas como secretos separados.
Qué puedes probar
Ensaya lo que vas a operar en producción
Cobros con tarjeta
Aprobaciones, rechazos, desafíos 3D Secure y errores de procesamiento, cada uno con su número de tarjeta de prueba.
Cuentas virtuales
Crea cuentas y simula transferencias entrantes para probar la identificación automática del pago, la conciliación y los webhooks.
Medios de pago locales
Crea cobros con Pix y otros medios locales, y revisa códigos QR, instrucciones de pago y estados pendientes.
Payouts
Ejecuta los escenarios de sandbox documentados para ver cada estado del flujo de payouts.
Webhooks de punta a punta
Apunta una URL de notificaciones de Stage a tu endpoint y verifica las firmas antes de producción.
Manejo de fallas
Repite un externalId para ver 409 Conflict, deja vencer un token y practica reintentos con backoff.
Tarjetas de prueba
Números de tarjeta para cada resultado
Usa cualquier fecha de vencimiento futura. CVC: cualquier número de 3 dígitos (4 para Amex).
4242 4242 4242 4242
- Resultado
- Aprobada
- Úsala para probar
- El camino feliz: autorización, confirmación y webhook
4000 0000 0000 0002
- Resultado
- Rechazada
- Úsala para probar
- Mensajes de rechazo y opciones de reintento en tu flujo de pago
4000 0025 0000 3155
- Resultado
- Desafío 3D Secure
- Úsala para probar
- El paso de autenticación y el regreso a tu flujo
4000 0000 0000 9995
- Resultado
- Error de procesamiento
- Úsala para probar
- Manejo de errores, registros y mensajes al cliente
Solo para Stage. La aceptación de tarjetas está disponible en Argentina, Colombia, México y Perú; 3D Secure aplica en Colombia, México y Perú.
Simulador de cuentas virtuales
Simula una transferencia cuando quieras
No hace falta esperar una transferencia real: crea una cuenta virtual en Stage, llama al simulador y sigue el pago simulado en la identificación automática, los cambios de estado y el procesamiento de tus notificaciones.
- POST /api/simulate/va está disponible solo en Stage
- Úsalo para probar el procesamiento de webhooks VirtualAccount antes del lanzamiento
- Ideal para pruebas automatizadas de punta a punta en tu pipeline de CI
# Solo en Stage. Cuerpos ilustrativos: consulta la guía de pruebas para el contrato exacto.
# 1) Crea una cuenta virtual para un cliente de prueba (México, CLABE)
curl -X POST https://api.stage.localpayment.com/api/virtual-account \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"externalId": "3b9f6c1e-0000-4000-8000-000000000123",
"country": "MEX",
"currency": "MXN",
"beneficiary": { "name": "Ana Torres", "document": { "type": "RFC", "id": "TOAA800101XXX" } }
}'
# 2) Simula una transferencia entrante a esa cuenta
curl -X POST https://api.stage.localpayment.com/api/simulate/va \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"accountNumber": "646180000000004821",
"amount": 1250.00,
"currency": "MXN"
}'
# 3) Tu endpoint de webhooks recibe una notificación VirtualAccountPostman
Importa la colección y envía tu primera solicitud
La colección de Postman de Localpayment incluye un archivo de entorno Stage para que explores la API antes de escribir una sola línea de código.
- Un archivo de entorno STAGE que dirige cada solicitud al sandbox
- Úsala junto con la referencia de la API para revisar la forma de solicitudes y respuestas
- Agrega tus credenciales de Stage en local y nunca compartas un espacio de trabajo que las contenga
Buenas prácticas
Prueba como si fuera producción
Solo datos ficticios
Usa nombres y números de documento inventados. Nunca cargues datos reales de clientes ni de tarjetas en Stage.
Secretos separados
Mantén separadas las credenciales de Stage y de producción, cada una en tu gestor de secretos.
Prueba los caminos difíciles
Rechazos, 3D Secure, tiempos de espera agotados, duplicados 409 y tokens vencidos, no solo aprobaciones.
Ejercita los reintentos de webhooks
Responde una vez con un código distinto de 200 y confirma que tu receptor aplica el reintento una sola vez.
Respeta la vida de los tokens
Los tokens de acceso duran 5 minutos. Construye la lógica de renovación ahora, no después del lanzamiento.
Automatiza tus pruebas
Ejecuta pruebas de punta a punta contra Stage en tu CI con el simulador de cuentas virtuales.
Cómo acceder
Cómo obtener credenciales de Stage
- 01
Cuéntanos sobre tu proyecto
Comparte tu caso de uso, tus mercados y los volúmenes que esperas en el formulario de contacto.
- 02
Inicia la alianza
Se acuerdan las condiciones comerciales y comienza la incorporación, que incluye una revisión de cumplimiento.
- 03
Recibe las credenciales de Stage
Obtienes un usuario y una contraseña de API para Stage, además de acceso al Business Portal de Stage.
- 04
Registra tus IP y construye
Agrega las IP de tus servidores, importa la colección de Postman y sigue la guía rápida.
Preguntas frecuentes sobre el sandbox
¿Stage mueve dinero real?
No. Stage replica el comportamiento de producción con fondos simulados. Nada de lo que hagas allí llega a un banco, una red de tarjetas o una billetera real.
¿Puedo usar datos reales de clientes en Stage?
No. Usa solo nombres, números de documento y tarjetas ficticios. Los datos personales o de tarjetas reales nunca deben enviarse a un entorno de pruebas.
¿En qué se diferencia Stage de producción?
El contrato de la API y los webhooks son los mismos. Los pagos son simulados (por ejemplo, las transferencias a cuentas virtuales vienen del simulador), así que los tiempos no reflejan los rieles reales.
¿Cómo paso a producción?
Completa las pruebas en Stage, la revisión de seguridad y la verificación de tu empresa (KYB). Luego emitimos las credenciales de producción. La guía rápida incluye la lista completa para salir a producción.
¿A quién contacto si algo no funciona?
Escribe a support@localpayment.com, disponible 24/7, o usa “Ask AI” en la documentación para respuestas rápidas.
Obtén tus credenciales de Stage
Inicia la conversación con nuestro equipo. El acceso a Stage se emite cuando comienza tu alianza.