Documentation Index
Fetch the complete documentation index at: https://docs.onepay.la/llms.txt
Use this file to discover all available pages before exploring further.
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 |
