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:https://api.play2sell.com por https://api-staging.play2sell.com y use una clave sk_test_.
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_.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
429y5xx; escrituras conidempotency_key - El ID de cada respuesta registrado en el log (
meta.request_id, oinstanceen 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 respondiendo2xxrá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.

