Una sandbox es una organización de prueba aislada: tiene una cartera con
deudores ficticios y ninguna otra organización puede ver sus datos. Sirve
para probar tu integración contra la API pública antes de tener una cuenta de
producción.
Pedí la sandbox desde el formulario de demo del sitio de Mozart, marcando
“Quiero probar la API en un entorno de prueba (sandbox)”:
mozarth.com/es?sandbox=1.Un miembro del equipo de Mozart revisa y aprueba cada pedido. Al aprobarlo:
se crea tu organización de prueba con una cartera sandbox de deudores
ficticios,
te llega un email de invitación para entrar a la plataforma,
el equipo de Mozart te entrega una clave moz_test_ (nunca por email),
igual que una clave moz_live_ (ver Autenticación).
Una clave moz_test_ sólo ve las carteras sandbox de su propia organización.
Dentro de ese alcance puede leer y escribir: deudores, pagos y cargas de
cartera, igual que una clave de producción con scope write. Los webhooks no
se configuran con la API key: los configura el equipo de Mozart (ver
Webhooks).
Ninguna llamada, mensaje de WhatsApp ni otro contacto sale nunca hacia una
persona real desde una sandbox: la organización de prueba no puede discar
llamadas reales.
Usá sólo datos ficticios en tu integración de prueba. No cargues deudores
reales en una sandbox: la cartera sandbox está pensada para eso y una carga
real ahí no cumple ningún propósito.
Una sandbox vence a los 30 días de aprobada. Pasado ese plazo, la clave deja
de funcionar: una clave moz_test_ vencida responde 401 unauthorized, lo
mismo que una clave revocada o expirada (ver
Paginación, errores y límites).
Una clave moz_live_ (o de cualquier otro stage productivo) no cambia de
comportamiento por la existencia de las sandboxes: sigue viendo las carteras
activas de su organización, igual que hoy.
