Saltar al contenido principal
Guía completa para probar la integración. Datos de prueba, escenarios y lista de verificación de validación. Prueba a fondo tu integración con Localpayment antes de tu lanzamiento. Esta guía completa proporciona datos de prueba, escenarios y procedimientos de validación para garantizar que tu implementación funcione correctamente con todos los métodos de pago y en casos excepcionales.

Requisitos previos

Antes de comenzar las pruebas, asegúrate de tener configurado lo siguiente:

Credenciales de API

Credenciales API válidas y token de acceso para la autenticación.

Configuración de la cuenta

Configuración adecuada de la cuenta para el país de destino y verificación de la empresa.

Lista blanca de IP

Incluye en la lista blanca las direcciones IP de tus servidores para el acceso a la API.

Endpoint del webhook

Configura una URL de webhook para recibir notificaciones de pago.

Entorno de pruebas

El entorno Stage es una réplica exacta de nuestro sistema de producción, diseñado específicamente para realizar pruebas:

Procesamiento realista

Simula los flujos y plazos de pago reales.

Sin dinero real

Todas las transacciones utilizan datos de prueba.

Conjunto completo de funciones

Todos los métodos y operaciones de pago están disponibles.

Pruebas aisladas

Los datos de tu entorno Stage se mantienen separados de los de producción.

Datos de prueba

Pagos con tarjeta

Prueba los pagos con tarjeta de crédito y débito en diferentes escenarios: Detalles estándar de la tarjeta:
  • Fecha de caducidad: Cualquier fecha futura (por ejemplo, 12/2029)
  • CVC: Cualquier número de 3 dígitos (por ejemplo, 123) para tarjetas Mastercard y Visa, o cualquier número de 4 dígitos (por ejemplo, 1234) para tarjetas American Express.
  • Nombre del titular de la tarjeta: Cualquier nombre de prueba (por ejemplo, “John Doe”)

Pruebas de escenarios de error

Errores de validación

  • Omite los campos obligatorios (paymentMethod, amount)
  • Utiliza formatos no válidos (moneda incorrecta, números de documento no válidos).
  • Prueba las restricciones de los parámetros (límites de monto, restricciones por país)

Pruebas de autenticación

  • Utilizar tokens de acceso caducados
  • Prueba con credenciales no válidas
  • Verificar las restricciones de la lista blanca de IP

Pruebas de webhook

Asegúrate de que tu endpoint de webhook gestione correctamente las notificaciones:

Configuración del endpoint

  • Verificar el requisito HTTPS
  • Prueba la verificación de firmas
  • Confirmar respuesta inmediata 200 OK

Procesamiento de eventos

  • Prueba todos los tipos de eventos (payins, payouts, cuentas virtuales)
  • Verificar el manejo de la idempotencia
  • Confirmar el procesamiento asíncrono

Manejo de errores

  • Prueba los escenarios de tiempo de espera
  • Verificar la lógica de reintento
  • Supervisar los fallos de entrega

Simulación de cuenta virtual (Stage)

Para las integraciones de cuentas virtuales, Localpayment proporciona un endpoint de simulación específico para probar el ciclo de vida completo (Creación -> Financiación -> Notificación).

Pagos de cuentas virtuales (simulación)

Para simular un pago exitoso en Stage, utiliza los mismos datos del beneficiario (nombre, tipo de documento e ID del documento) que se proporcionaron al crear la cuenta virtual. No se requieren identidades de prueba adicionales; el endpoint Simular un pago de cuenta virtual validará los datos del pagador con la información registrada durante la creación de la cuenta.

Escenarios de prueba principales:

Importante
  • Mapeo de campos: Para la llamada de simulación, utiliza el beneficiary.bank.account.number devuelto por Obtener estado de la cuenta virtual para identificar la cuenta de destino. El externalId de la solicitud de simulación debe ser un identificador único de la transacción de payin; utiliza un valor diferente para cada solicitud. Incluye también tu accountNumber real (Merchant ID) para identificar el proyecto.
  • Identidades: Utiliza los mismos datos del beneficiario (nombre, tipo de documento e identificación) que se proporcionaron al crear la cuenta virtual. Consulta la Guía completa de simulación para obtener más detalles.

Lista de verificación de validación

Antes de pasar a producción, verifica:
  • Flujos de pago: Confirma que todos los métodos de pago funcionan correctamente, incluyendo tanto los casos de éxito como los de error.
  • Gestión de webhooks: Asegúrate de que todos los eventos de webhook se reciban, verifiquen y procesen según lo previsto.
  • Gestión de errores: Mostrar mensajes de error claros a los usuarios e implementar la lógica de reintento adecuada cuando sea necesario.
  • Seguridad: Implementar HTTPS, verificar las firmas y garantizar que todos los datos confidenciales se manejen de forma segura.
  • Experiencia de usuario: Proporcionar estados de carga claros, mensajes útiles y flujos de redireccionamiento fluidos a lo largo de todo el proceso de pago.

Herramientas de prueba

Descarga nuestra colección completa de Postman con escenarios de prueba preconfigurados:

Postman Collection

Obtén la colección completa de pruebas con plantillas de entorno.
Última modificación el 10 de noviembre de 2026