El sandbox en el panel
El sandbox en el panel
No todo tiene que hacerse por API. El panel puede mostrarte los datos de tu sandbox con el mismo aspecto y las mismas pantallas que usas todos los días.
Encender el modo sandbox
Arriba a la derecha, junto a la ayuda y tu perfil, hay un switch "Modo sandbox". Al encenderlo, el panel entero pasa a mostrar los datos de tu organización sandbox, y una franja ámbar fija cruza el borde superior de la ventana —por encima del menú lateral— para que nunca haya duda de en qué mundo estás.
El mismo switch te devuelve a producción. Es el único control: la franja solo avisa.
La primera vez que lo enciendes, si nunca habías usado tu clave pvtk_, el sandbox se
crea en ese momento y se abre vacío pero funcionando.
Qué cambia mientras está encendido
Ves y editas los datos del sandbox: catálogo, clientes, suscripciones, facturas, transacciones y webhooks. Todo lo que hagas ahí es de mentira y nada sale hacia afuera.
Tres secciones desaparecen del menú mientras estás en modo sandbox:
| Sección | Por qué no está |
|---|---|
| API Keys | Tu sandbox no tiene claves propias. Se llega a él con la clave pvtk_ de tu organización real, que vive en la página de producción |
| Organización | Los datos fiscales, el logo y las credenciales bancarias son de tu negocio de verdad |
| Miembros | Los permisos son los mismos que ya tienes en tu organización real |
Tu rol se conserva: si en tu organización eres solo lectura, en el sandbox también.
El ID que aparece bajo el nombre de tu organización, en el menú lateral, sigue siendo el
de tu organización real. Es el que va en el header Organization junto con tu clave
pvtk_, así que puedes copiarlo y usarlo tal cual.
Los medios de pago del sandbox no se configuran: son siempre domiciliación, débito inmediato y tarjeta, con cualquier banco de producción, y la tarjeta aparece cuando tu organización real la tiene habilitada. Ver Los medios de pago del sandbox.
Webhooks se queda a propósito. Probarlos contra datos de prueba es una de las razones por las que existe el sandbox. Ver Probar webhooks.
Copiar tu catálogo al sandbox
Para no recrear a mano lo que ya tienes, desde la organización real puedes copiar al sandbox un plan suelto —con el botón de la fila, en la tabla de planes— o el catálogo completo, con "Copiar catálogo a sandbox".
La copia arrastra todo lo que ese plan necesita para funcionar:
- su producto;
- su medidor, con los tramos de uso, si es un plan medido;
- su descuento;
- los planes que aparezcan como ítems adicionales, y los productos de esos planes.
La copia se queda entera o no se copia: si a un plan le falla alguna de sus partes, ese plan se reporta por su nombre y no queda a medias. Los demás sí se copian.
Dos cosas que conviene saber
- Es una foto del momento del clic, no un enlace vivo. Si cambias el precio en producción, la copia del sandbox se queda como estaba hasta que vuelvas a copiar.
- Volver a copiar reemplaza, no duplica. La copia del sandbox se actualiza con la versión actual y los cambios que le hayas hecho a mano allí se pierden. El panel te lo advierte antes de confirmar.
La copia va siempre en un solo sentido, de producción al sandbox. Nada de lo que crees en el sandbox puede pasar a producción, y por eso la acción solo se ofrece desde la organización real.
Un plan medido no puede sobrescribir a uno de precio fijo que ya exista en el sandbox con el mismo nombre, ni al revés: el tipo de precio de un plan no se puede cambiar una vez creado. Si pasa, el plan se reporta por su nombre y basta con borrarlo en el sandbox y copiar de nuevo.
Los ids no son los mismos
La copia en el sandbox es un objeto nuevo, con su propio id y livemode: false. Si tu
integración guarda ids de planes o productos, los del sandbox y los de producción son
distintos — que es exactamente lo que hace que los dos mundos no se mezclen.