Sandbox de pruebas

Qué es el sandbox

CelMex Sandbox replica los mismos contratos de CelMex API v1, pero nunca coloca pedidos reales ni toca saldo productivo.

Está diseñado para que tu equipo pueda:

• validar autenticación y manejo de errores;
• probar creación de pedidos e idempotencia;
• ejercitar polling y estados terminales;
• inspeccionar payloads reales esperados por CelMex;
• hacer QA o staging antes de ir a producción.

Base URLs

La URL que debes usar es la que CelMex te asigne en el panel para tu cuenta.

Valores por defecto documentados:

• Producción: https://celmexunlockers.com/api/v1
• Sandbox: https://celmexunlockers.com/api/sandbox/v1

Autenticación

Sandbox usa su propia API key:

Authorization: Bearer clx_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

La key productiva clx_live_... no debe usarse para pruebas.

Antes de pedir activación productiva, tu integración debe pasar el suite completo documentado en:

• Activación y go-live

Endpoints espejo

Todos estos endpoints existen en sandbox con el mismo contrato que producción:

Endpoints de apoyo para testing

Además del espejo productivo, sandbox expone endpoints de ayuda:

Escenarios soportados

También puedes usar el endpoint estándar POST /api/sandbox/v1/orders y controlar el resultado con el header:

X-CelMex-Sandbox-Scenario: success

Valores válidos:

• success
• pending
• failed
• rejected

Si no mandas el header, sandbox usa success.

Body real de ejemplo

{
  "serviceId": "srv_01K5CB4D6F7G8H9J0K1L2M3N4P",
  "clientReference": "sale_20260321_000101",
  "inputs": {
    "IMEI": "352099001761482"
  }
}

Ejemplo de pedido exitoso

curl -X POST "https://celmexunlockers.com/api/sandbox/v1/orders" \
  -H "Authorization: Bearer clx_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ik_01K5CB0V2N8M7Q6W5E4R3T2Y1U" \
  -H "X-CelMex-Sandbox-Scenario: success" \
  -d '{
    "serviceId": "srv_01K5CB4D6F7G8H9J0K1L2M3N4P",
    "clientReference": "sale_20260321_000101",
    "inputs": {
      "IMEI": "352099001761482"
    }
  }'

Comportamiento de cada escenario

• success: acepta el pedido y lo completa automáticamente después de unos segundos.
• pending: acepta el pedido y lo deja en PROCESSING para que pruebes polling.
• failed: responde con error terminal y deja la orden en FAILED.
• rejected: responde con rechazo terminal y deja la orden en REJECTED.

Payloads de referencia

Si quieres ver payloads listos para documentación interna o Postman, consulta:

• GET /api/sandbox/v1/testing
• GET /api/sandbox/v1/testing/payloads

Validación obligatoria

CelMex debe tratar sandbox como requisito obligatorio antes de habilitar producción.

Tu equipo debe poder demostrar que:

• los cuatro escenarios funcionan;
• idempotencia se comporta correctamente;
• puedes consultar el estado de las órdenes con polling;
• testing/reset deja el entorno limpio;
• tu integración no intenta usar la llave sandbox contra producción.

Qué sí y qué no hace

Sandbox sí hace:

• autenticar con Bearer token;
• devolver catálogo real de CelMex con tus precios API;
• guardar pedidos sandbox para que puedas listarlos y consultarlos;
• respetar idempotencia;
• simular estados y tiempos de resolución.

Sandbox no hace:

• colocar pedidos en UnlockerFast;
• tocar saldo productivo;
• crear órdenes reales en CelMex;
• generar movimientos financieros reales.