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

API

Empresas

Métodos de pago

Recaudo

Productos

Facturación

Balances

Webhooks

Fintech as a service

Escenarios de prueba

Escenarios de prueba

¿Cómo usarlos?

Escenarios disponibles

Errores de tarjeta

Errores de fondos y fraude

Errores de cuenta bancaria

Errores de transacción

Errores generales

​Escenarios de prueba

​¿Cómo usarlos?

​Escenarios disponibles

​Errores de tarjeta

​Errores de fondos y fraude

​Errores de cuenta bancaria

​Errores de transacción

​Errores generales

Escenarios de prueba

¿Cómo usarlos?

Escenarios disponibles

Errores de tarjeta

Errores de fondos y fraude

Errores de cuenta bancaria

Errores de transacción

Errores generales