Escenarios de prueba
Los escenarios de prueba te permiten simular diferentes resultados de transacciones para verificar el comportamiento de tu integración antes de pasar a producción.
¿Cómo usarlos?
Al crear un cargo con POST /charges, envía el campo test_scenario con el código del escenario que quieres simular:
curl https://api.onepay.la/v1/charges \
-X POST \
-H "Authorization: Bearer sk_test_xxx" \
-H "Content-Type: application/json" \
-H "x-idempotency: test-scenario-001" \
-d '{
"title": "Prueba de error",
"customer_id": "9dd4158b-0e45-42bc-b56f-a4c1f856814d",
"amount": 50000,
"card_id": "9e5ccd4a-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"test_scenario": "INSUFFICIENT_FUNDS"
}'
Los escenarios de prueba solo funcionan con llaves de ambiente test (sk_test_). En producción, el campo test_scenario es ignorado.
Escenarios disponibles
Errores de tarjeta
| Escenario | Descripción |
|---|
CARD_NUMBER | Número de tarjeta inválido |
CARD_EXPIRED | Tarjeta expirada |
CARD_DATE | Fecha de expiración inválida |
CARD_CVV | Código de seguridad (CVV) incorrecto |
CARD_VELOCITY | Tarjeta bloqueada por exceso de intentos |
CARD_GENERIC_ERROR | Error genérico de tarjeta |
CARD_RESTRICTED | Tarjeta restringida por el emisor |
Errores de fondos y fraude
| Escenario | Descripción |
|---|
INSUFFICIENT_FUNDS | Fondos insuficientes en la cuenta |
FRAUDULENT | Transacción marcada como fraudulenta |
STOLEN | Tarjeta reportada como robada |
Errores de cuenta bancaria
| Escenario | Descripción |
|---|
ACCOUNT_NOT_CONNECTED | Cuenta no vinculada o sin autorización |
ACCOUNT_BLOCKED | Cuenta bloqueada por el banco |
ACCOUNT_CLOSED | Cuenta cerrada |
ACCOUNT_FAILED | Error al procesar la cuenta |
ACCOUNT_IS_NOT_AUTHORIZED | La cuenta no está autorizada para débitos |
ACCOUNT_DOES_NOT_BELONG_TO_CUSTOMER | La cuenta no pertenece al cliente especificado |
Errores de transacción
| Escenario | Descripción |
|---|
TRANSACTION_NOT_FOUND | Transacción no encontrada en el procesador |
TRANSACTION_EXPIRED | Transacción expirada por tiempo |
TRANSACTION_REJECTED | Transacción rechazada por el banco |
TRANSACTION_TEMPORALLY_BLOCKED | Transacción bloqueada temporalmente |
Errores generales
| Escenario | Descripción |
|---|
INTERNAL_ERROR | Error interno del sistema |
CURRENCY_NOT_SUPPORTED | Moneda no soportada |
MIN_AMOUNT | Monto menor al mínimo permitido |
MAX_AMOUNT | Monto mayor al máximo permitido |
BANK_IS_NOT_AVAILABLE | Banco no disponible en este momento |
CUSTOMER_DATA_INVALID | Datos del cliente inválidos o incompletos |
UNKNOWN | Error desconocido |
