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:https://api.play2sell.com por https://api-staging.play2sell.com e use uma chave sk_test_.
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 que testar em Staging
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
429e5xx; escritas comidempotency_key - O ID de cada resposta registrado no log (
meta.request_id, ouinstancenos erros de Pagamentos), para o suporte achar qualquer chamada - Endpoint de webhook em produção com
https://, público, conferindo a assinatura e respondendo2xxrá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.

