> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pruebas

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:

> [card] [Credenciales de API](https://docs.localpayment.com/es/docs/api-keys-and-environments.md)
>
> Credenciales API válidas y token de acceso para la autenticación.

> [card] [Configuración de la cuenta](https://docs.localpayment.com/es/docs/make-your-first-test-payment.md)
>
> Configuración adecuada de la cuenta para el país de destino y verificación de la empresa.

> [card] [Lista blanca de IP](https://docs.localpayment.com/es/docs/dashboard-whitelist-your-ips.md)
>
> Incluye en la lista blanca las direcciones IP de tus servidores para el acceso a la API.

> [card] [Endpoint del webhook](https://docs.localpayment.com/es/docs/webhooks.md)
>
> 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:

> [card] Procesamiento realista
>
> Simula los flujos y plazos de pago reales.

> [card] Sin dinero real
>
> Todas las transacciones utilizan datos de prueba.

> [card] Conjunto completo de funciones
>
> Todos los métodos y operaciones de pago están disponibles.

> [card] 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:

| Número de tarjeta | Escenario | Resultado esperado | Propósito de la prueba |
| - | - | - | - |
| 4242424242424242 | ✅ Pago exitoso | Aprobación inmediata | Flujo de pago básico |
| 4000000000000002 | ❌ Tarjeta rechazada | Rechazar con justificación | Manejo de rechazos |
| 4000002500003155 | 🔐 Se requiere 3D Secure | Redirección de autenticación | Flujo 3D Secure |
| 4000000000009995 | ⚠️ Error de procesamiento | Fallo temporal | Controles de saldo |

**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](https://docs.localpayment.com/es/reference/simulate-payin-to-virtual-account.md) validará los datos del pagador con la información registrada durante la creación de la cuenta.

### Escenarios de prueba principales:

| Escenario | Objetivo | Requisito |
| :- | :- | :- |
| **Verificar estado** | Confirmar la activación de la cuenta | Verifica [Obtener estado de la cuenta virtual](https://docs.localpayment.com/es/reference/get-virtual-account-status.md) después de crear la cuenta. |
| **Simular pago** | Simula un pago ficticio. | Utiliza la función [Simular un pago a una cuenta virtual](https://docs.localpayment.com/es/reference/simulate-payin-to-virtual-account.md) con los mismos datos del beneficiario que al crear la cuenta. |
| **Entrega mediante webhook** | Validar la lógica del oyente | Asegúrate de recibir `payin.completed` (status: `COMPLETED`) después de la simulación. |

> [!NOTE]
>
> **Importante**
>
> * **Mapeo de campos**: Para la llamada de simulación, utiliza el `beneficiary.bank.account.number` devuelto por [Obtener estado de la cuenta virtual](https://docs.localpayment.com/es/reference/get-virtual-account-status.md) 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](https://docs.localpayment.com/es/docs/simulate-virtual-account-payment.md) 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:

> [card] [Postman Collection](https://docs.localpayment.com/es/reference/postman-collection.md)
>
> Obtén la colección completa de pruebas con plantillas de entorno.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.