> ## Documentation Index
> Fetch the complete documentation index at: https://docs.play2sell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ambientes

> Construya y pruebe en Staging, luego salga en vivo en Producción. La misma API, con datos y claves separados.

SalesOS tiene dos ambientes. Ambos ejecutan **la misma API** — mismos endpoints, acciones, campos y errores — con **datos y claves separados**.

| | Staging | Producción |
| - | - | - |
| **Para qué sirve** | Construir y probar su integración | Empresas, personas y dinero reales |
| **URL base de la API** | `https://api-staging.play2sell.com` | `https://api.play2sell.com` |
| **Panel** | `https://app-staging.play2sell.com` | `https://app.play2sell.com` |
| **Prefijo de la clave** | `sk_test_` | `sk_live_` |
| **Datos** | Empresas y personas de prueba | Los datos reales de su empresa |
| **Pagos** | Modo de prueba del proveedor: no se mueve dinero real | Cobros reales |
| **Versiones nuevas** | Llegan primero | Llegan después de verificarse en Staging |

> [!NOTE]
>
> 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:

```bash Staging theme={null}
export P2S_BASE_URL="https://api-staging.play2sell.com"
export P2S_API_KEY="sk_test_..."
export P2S_API_KEY_SECRET="..."
```

```bash Producción theme={null}
export P2S_BASE_URL="https://api.play2sell.com"
export P2S_API_KEY="sk_live_..."
export P2S_API_KEY_SECRET="..."
```

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_`.

> [!WARNING]
>
> 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

| Área | Qué probar |
| - | - |
| Firma | Una llamada correcta y una con el secreto equivocado (`401 signature_invalid`), para que sus logs muestren la diferencia |
| Alcances | Una llamada que su clave no puede hacer (`403 scope_insufficient`) |
| Validación | Una solicitud sin un campo obligatorio (`400 VALIDATION_ERROR` con `details`) |
| Reintentos | La misma escritura dos veces con la misma `idempotency_key`: la segunda respuesta trae `idempotent_replayed: true` |
| Límites | Lotes del tamaño máximo de cada acción |
| Webhooks | **Test Webhook** en el Panel y verificación de la firma de su lado |
| Pagos | Cree un cobro y siga su estado; en Staging no se mueve dinero real |

## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.