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

> Construa e teste em Staging, depois entre no ar em Produção. Mesma API, dados e chaves separados.

O SalesOS tem dois ambientes. Os dois rodam **a mesma API** — mesmos endpoints, ações, campos e erros — com **dados e chaves separados**.

| | Staging | Produção |
| - | - | - |
| **Para que serve** | Construir e testar a sua integração | Empresas, pessoas e dinheiro de verdade |
| **URL base da API** | `https://api-staging.play2sell.com` | `https://api.play2sell.com` |
| **Painel** | `https://app-staging.play2sell.com` | `https://app.play2sell.com` |
| **Prefixo da chave** | `sk_test_` | `sk_live_` |
| **Dados** | Empresas e pessoas de teste | Os dados reais da sua empresa |
| **Pagamentos** | Modo de teste do provedor: nenhum dinheiro de verdade circula | Cobranças reais |
| **Versões novas** | Chegam primeiro | Chegam depois de conferidas em Staging |

> [!NOTE]
>
> Chave nunca atravessa ambiente. Uma `sk_live_` enviada a Staging, ou uma `sk_test_` enviada a Produção, recebe `401` com `code: "api_key_not_found"`.

## O ambiente é escolhido pela URL base

Só a URL base muda. Caminhos, corpos e assinaturas são idênticos; por isso, URL base e chave ficam na configuração, nunca no 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 Produção theme={null}
export P2S_BASE_URL="https://api.play2sell.com"
export P2S_API_KEY="sk_live_..."
export P2S_API_KEY_SECRET="..."
```

Todos os exemplos desta documentação usam a URL de produção. Para rodar em Staging, troque `https://api.play2sell.com` por `https://api-staging.play2sell.com` e use uma chave `sk_test_`.

> [!WARNING]
>
> A assinatura cobre o caminho, não o host: o mesmo pedido assinado vale no outro ambiente **só com a chave daquele ambiente**. Nunca reaproveite chave de produção em ferramenta de teste.

## Uma chave para cada ambiente

**1. Staging**

Peça ao seu contato na Play2sell acesso a uma **empresa de teste** em Staging. Depois, em `https://app-staging.play2sell.com`, vá em **Admin > Integrações > Chaves de API** e crie uma chave com os escopos que a integração usa. Ela começa com `sk_test_`.

**2. Produção**

Quando a integração passar na lista abaixo, um admin da sua empresa cria a chave em `https://app.play2sell.com`, no mesmo menu e com os mesmos escopos. Ela começa com `sk_live_`.

O segredo aparece **uma única vez**, na criação da chave. Guarde num cofre de segredos.

## O que testar em Staging

| Área | O que experimentar |
| - | - |
| Assinatura | Uma chamada certa e uma com segredo errado (`401 signature_invalid`), para os seus logs mostrarem a diferença |
| Escopos | Uma chamada que a chave não pode fazer (`403 scope_insufficient`) |
| Validação | Um pedido sem um campo obrigatório (`400 VALIDATION_ERROR` com `details`) |
| Repetição | A mesma escrita duas vezes com a mesma `idempotency_key`: a segunda resposta traz `idempotent_replayed: true` |
| Limites | Lotes no tamanho máximo de cada ação |
| Webhooks | **Test Webhook** no Painel e conferência da assinatura do seu lado |
| Pagamentos | Crie uma cobrança e acompanhe a situação; em Staging nenhum dinheiro de verdade circula |

## Lista para entrar no ar

* [ ] URL base e chave vêm da configuração; nada de ambiente no código
* [ ] Uma chave `sk_live_` só com os escopos usados
* [ ] Segredo num cofre de segredos, fora do repositório e dos logs
* [ ] Relógio do servidor sincronizado (a assinatura vale por 30 segundos)
* [ ] Novas tentativas com espera progressiva em `429` e `5xx`; escritas com `idempotency_key`
* [ ] O ID de cada resposta registrado no log (`meta.request_id`, ou `instance` nos erros de Pagamentos), para o suporte achar qualquer chamada
* [ ] Endpoint de webhook em produção com `https://`, público, conferindo a assinatura e respondendo `2xx` rápido
* [ ] As primeiras chamadas em produção acompanhadas por um dia

## Boas práticas

* **Escrita se testa em Staging.** Explorar com leitura em produção é tranquilo; experimentar escrita, não.
* **Dado de teste fica em Staging.** Não copie dados de pessoas reais para Staging.
* **Versão nova aparece primeiro em Staging.** Se algo muda, você vê lá antes de chegar à produção.


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