Activación y go-live

Regla de activación

CelMex no debe habilitar tu uso productivo hasta que tu integración pase el suite completo de sandbox.

Eso incluye:

• autenticación con llave clx_test_...;
• lectura de catálogo y detalle de servicio;
• creación de órdenes sandbox;
• idempotencia;
• polling de estados success, pending, failed y rejected;
• limpieza final del sandbox.

Si esta validación no pasa, tu acceso productivo debe permanecer bloqueado.

Qué debes pedir a CelMex

Antes de correr pruebas necesitas, como mínimo:

• Sandbox API key
• Production API key
• Sandbox base URL
• Production base URL

Importante:

• Las llaves son por entorno y no son intercambiables.
• Una llave generada en local o dev no funciona contra producción.
• Si apuntas una llave del entorno equivocado, recibirás INVALID_API_KEY.

Qué debes probar en sandbox

Antes de pedir habilitación productiva, tu integración debe probar como mínimo:

• GET /health
• GET /account
• GET /balance
• GET /services
• GET /services/:serviceId
• POST /orders
• uso correcto de Idempotency-Key
• polling de GET /orders/:orderId/status
• escenarios success, pending, failed y rejected
• POST /testing/reset al final

Puedes hacer estas pruebas con curl, Postman, Insomnia o tu propio backend.

Ejemplos mínimos con cURL

Verificar autenticación:

curl -X GET "https://celmexunlockers.com/api/sandbox/v1/account" \
  -H "Authorization: Bearer clx_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Crear un pedido de prueba:

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_20260322_demo_001" \
  -H "X-CelMex-Sandbox-Scenario: success" \
  -d '{
    "serviceId": "srv_xxxxxxxxxxxxxxxxxxxxxxxx",
    "clientReference": "demo_order_001",
    "inputs": {
      "IMEI": "352099001761482"
    }
  }'

Consultar estado:

curl -X GET "https://celmexunlockers.com/api/sandbox/v1/orders/ord_xxxxxxxxxxxxxxxxxxxxxxxx/status" \
  -H "Authorization: Bearer clx_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Limpiar el sandbox:

curl -X POST "https://celmexunlockers.com/api/sandbox/v1/testing/reset" \
  -H "Authorization: Bearer clx_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Qué debes entregar para aprobación

Antes de que CelMex habilite producción para tu cuenta, debes compartir:

• evidencia de las pruebas realizadas;
• environment probado;
• fecha y hora de ejecución;
• requestId de cualquier error;
• confirmación de que el sandbox quedó limpio al final.

Criterio de bloqueo

Producción no debe habilitarse si ocurre cualquiera de estos casos:

• la llave productiva o sandbox devuelve INVALID_API_KEY;
• falla idempotencia;
• el polling no llega al estado esperado;
• testing/reset no limpia el entorno;
• no se validaron correctamente los escenarios de sandbox.