Conceptos
Ambientes y URLs base
Hosts de staging vs producción para backend-skip, gokeipay-api y el widget.
Skip corre dos ambientes. Ambos tienen funcionalidad completa. Usa staging para desarrollo y testing de integración; cambia a producción cuando salgas en vivo.
Hosts
| Servicio | Staging | Producción |
|---|---|---|
| Backend Skip (endpoints Spot, ISAPRE, notificaciones) | staging.backend.getskip.ai/api | backend.getskip.ai/api |
| SkipPay (órdenes AAPD, reembolsos, ops de cliente) | staging.pay.getskip.ai | pay.getskip.ai |
| Widget Spot | staging.spot.getskip.ai | spot.getskip.ai |
Eligiendo ambiente
Las credenciales de staging están separadas de las de producción. Si tu public_key es pk_test_*, estás en staging. Si es pk_live_*, estás en producción.
Cuando Skip te onboardea, recibes ambos pares. Configúralos vía variables de entorno:
# staging
SKIPPAY_API_URL=https://staging.pay.getskip.ai
SKIP_BACKEND_URL=https://staging.backend.getskip.ai/api
SPOT_WIDGET_URL=https://staging.spot.getskip.ai
SKIP_PUBLIC_KEY=pk_test_xxx
SKIPPAY_CLIENT_ID=ci_test_xxx
SKIPPAY_CLIENT_SECRET=st_test_xxx
# producción
SKIPPAY_API_URL=https://pay.getskip.ai
SKIP_BACKEND_URL=https://backend.getskip.ai/api
SPOT_WIDGET_URL=https://spot.getskip.ai
SKIP_PUBLIC_KEY=pk_live_xxx
SKIPPAY_CLIENT_ID=ci_live_xxx
SKIPPAY_CLIENT_SECRET=st_live_xxxQué es igual en ambos
- Paths y shapes de endpoints son idénticos.
- Esquema de firma de webhook es idéntico.
- El origen del widget que validas en
postMessagees siemprehttps://spot.getskip.ai— el widget de staging también vive enstaging.spot.getskip.ai, pero el origen del mensaje es configurable por ambiente. Verifica que el origen que efectivamente cargas coincida con el que chequeas.
Qué es distinto
- Staging Ventipay es sandbox — no se mueve plata real.
- Mensajes WhatsApp de staging van a un único número de prueba (de Skip), no al paciente real.
- Presentación ISAPRE de staging está mockeada — los reembolsos se aprueban instantáneamente sin contactar la infraestructura ISAPRE real.
Si necesitas un comportamiento de staging más fiel (ej. simular el timeout de 45 días), pídele a ops; pueden adelantar timelines de orden para testing.