Pruebas en sandbox

Sandbox es una copia completa de la API Pay-In que no mueve dinero real. Úsalo para construir y certificar tu integración antes de salir a producción.

Base URL	https://sandbox-api.cashela.com
Credenciales	Una clave de la tarjeta Sandbox del Portal de Desarrolladores
Dinero	Ninguno. No hay pagos reales.

Llevar un depósito a su estado final

En sandbox no hay pagos reales, así que tus depósitos quedan en curso hasta que decides su resultado con simulate. Lleva un depósito de sandbox a COMPLETED, DECLINED o CANCELLED igual que lo haría un pago real, incluida la notificación firmada a la notification_url del depósito.

POST/api/v1/pay-in/sandbox/transactions/{reference}/simulate

Entorno	Solo sandbox. En producción esta ruta responde 404.
{reference}	La reference del depósito, tu external_identifier o el id del depósito.
Cuerpo	{ "status": "COMPLETED" }, o DECLINED, o CANCELLED.
Límite	30 peticiones por minuto.

curl -X POST https://sandbox-api.cashela.com/api/v1/pay-in/sandbox/transactions/order-2026-0001/simulate \
  -u "$CASHELA_SANDBOX_API_KEY:$CASHELA_SANDBOX_API_SECRET" \
  -H "Content-Type: application/json" -H "Accept: application/json" \
  -d '{ "status": "COMPLETED" }'

La respuesta es el depósito, tal como lo devuelve Consultar un depósito, con su nuevo estado.

HTTP	Cuándo
404	Referencia desconocida, un depósito de otra cuenta, o la llamada se envió a producción.
409	El depósito ya es final (PARTNER_PAYIN_SIMULATION_ALREADY_FINAL). Solo se puede simular un depósito que siga en curso.
422	status no es COMPLETED, DECLINED ni CANCELLED ("The selected status is invalid.").

Una certificación típica

1. Camino feliz. Crea un depósito y simula COMPLETED. Verifica la firma de la notificación, cómo registras el abono y que respondes 2xx.
2. Camino de error. Crea un segundo depósito y simula DECLINED o CANCELLED. Verifica que tu sistema marca el pedido como no pagado y no acredita nada.
3. Conciliación. Consulta ambos depósitos con Consultar un depósito y compáralos con tus registros.
4. Idempotencia. Repite una creación con el mismo external_identifier y el mismo cuerpo: debes recibir el depósito original. Repítela con otro cuerpo: debes recibir 409.
5. Validación. Envía datos del pagador no válidos (por ejemplo un teléfono de otro país) y comprueba que tu formulario muestra los mensajes del 422.
6. Recuperación. Usa el endpoint de reenvío para recibir otra vez una notificación.

Repite hasta que las verificaciones de preparación para go-live estén en verde. El mínimo es 5 depósitos completados, 3 notificaciones confirmadas con 2xx, 1 caso de error gestionado (un depósito que termina en DECLINED, CANCELLED o FAILED), ningún fallo de autenticación en los últimos 7 días y actividad en los últimos 14 días.

Sandbox no es producción

Producción valida con más rigor

Producción aplica validaciones estrictas que sandbox puede no aplicar: teléfono válido para el país del depósito, formato y dígito verificador del documento, correo entregable y patrón de código postal. Sandbox puede aceptar datos que producción rechaza. Prueba con datos en el formato real de cada país y gestiona cada 422 en tu formulario. Ver Datos del pagador y documentos.

• El catálogo (países, métodos, comisiones, límites) puede ser distinto entre sandbox y producción. No copies códigos de método de sandbox a tu código de producción: consulta siempre Obtener métodos de pago.
• Las credenciales, depósitos y referencias de sandbox y producción están separados.
• Evita intentos de autenticación fallidos en sandbox (clave o secreto incorrectos): ponen en rojo la verificación Autenticación sin errores durante 7 días.