Saltar al contenido principal
SalesOS tiene dos ambientes. Ambos ejecutan la misma API — mismos endpoints, acciones, campos y errores — con datos y claves separados.
Las claves nunca cruzan de ambiente. Una sk_live_ enviada a Staging, o una sk_test_ enviada a Producción, recibe 401 con code: "api_key_not_found".

El ambiente se elige por la URL base

Solo cambia la URL base. Rutas, cuerpos y firmas son idénticos; por eso la URL base y la clave van en la configuración, nunca en el código:
Todos los ejemplos de esta documentación usan la URL de producción. Para ejecutarlos en Staging, cambie https://api.play2sell.com por https://api-staging.play2sell.com y use una clave sk_test_.
La firma cubre la ruta, no el host: la misma solicitud firmada vale en el otro ambiente solo con la clave de ese ambiente. Nunca reutilice una clave de producción en herramientas de prueba.

Una clave para cada ambiente

1

Staging

Pida a su contacto en Play2sell acceso a una empresa de prueba en Staging. Luego, en https://app-staging.play2sell.com, vaya a Admin > Integraciones > Claves de API y cree una clave con los alcances que usa su integración. Empieza con sk_test_.
2

Producción

Cuando su integración pase la lista de abajo, un admin de su empresa crea la clave en https://app.play2sell.com, en el mismo menú y con los mismos alcances. Empieza con sk_live_.
El secreto se muestra una sola vez, al crear la clave. Guárdelo en un gestor de secretos.

Qué probar en Staging

Lista para salir en vivo

  • La URL base y la clave vienen de la configuración; nada del ambiente en el código
  • Una clave sk_live_ solo con los alcances que usa
  • El secreto en un gestor de secretos, fuera del repositorio y de los logs
  • El reloj del servidor sincronizado (la firma vale 30 segundos)
  • Reintentos con espera progresiva ante 429 y 5xx; escrituras con idempotency_key
  • El ID de cada respuesta registrado en el log (meta.request_id, o instance en los errores de Pagos), para que soporte encuentre cualquier llamada
  • El endpoint de webhooks en producción con https://, público, verificando la firma y respondiendo 2xx rápido
  • Las primeras llamadas en producción monitoreadas durante un día

Buenas prácticas

  • Las escrituras se prueban en Staging. Explorar con lecturas en producción está bien; probar escrituras, no.
  • Los datos de prueba se quedan en Staging. No copie datos de personas reales a Staging.
  • Las versiones nuevas aparecen primero en Staging. Si algo cambia, lo ve allí antes de que llegue a producción.