Ambientes

Diferencias entre Sandbox y En vivo en la API de partners de SLAN, y cómo conseguir una credencial para probar.

Hay dos ambientes, Sandbox y En vivo. Cambian la URL base y poco más: el contrato es el mismo, así que lo que funciona en Sandbox funciona en vivo.

Son los dos nombres del conmutador de la cabecera de este sitio. Lo que elijas ahí gobierna a la vez la URL de los ejemplos y a dónde va el botón «Ejecutar» de cada operación.

	Sandbox	En vivo
URL base	`https://api-dev.slan.mx`	`https://api.slan.mx`
Credencial	Te la emites tú al momento	La emite SLAN
Datos	Ficticios, se pueden borrar	Reales
Cobros	No mueven dinero	Mueven dinero de verdad

Conseguir una credencial de Sandbox

En Sandbox hay un endpoint que emite credenciales sin intervención humana:

curl -X POST https://api-dev.slan.mx/v1/partner/sandbox/api-key

Devuelve una llave slan_... lista para usar. Es la única ruta de la API que no exige credencial, y solo existe en Sandbox: en vivo no está registrada, así que responde 404.

Esa asimetría es intencional. No hay ninguna forma de emitirse a uno mismo una credencial en vivo. Por eso, en la página de esa operación, el botón «Ejecutar» desaparece si tienes el conmutador en «En vivo»: no tendría a dónde llamar.

Lo que no funciona igual en Sandbox

Los proveedores externos (el emisor de wallets, el checkout) responden en Sandbox contra sus propios entornos de prueba. Eso significa que puedes ver un status: PENDING en una wallet por motivos que en vivo no se darían. La forma de tratarlo es la misma: volver a consultar, nunca crear otra.

Pasar a en vivo

Cuando tu integración funcione en Sandbox:

Pide tu credencial en vivo indicando qué operaciones vas a usar, para que traiga los scopes correctos.
Cambia la URL base y la llave. No hay nada más que cambiar.
Verifica con GET /v1/partner/ping y GET /v1/partner/me antes de mover nada.