Documentação · Guias
Passar a produção
Uma lista curta para passar da integração de teste para os dados reais sem surpresas.
Lista de verificação
- O plano inclui a API em produção (Pro ou Enterprise). As chaves de teste funcionam em qualquer plano.
- Crie uma chave sk_live_ e guarde-a só no servidor. Troque a chave de teste por esta numa variável de ambiente, sem mudar código.
- Crie o endereço de webhook de produção (os de teste não recebem eventos reais) e verifique a assinatura.
- Use Idempotency-Key em todos os POST que o seu sistema possa repetir.
- Trate os erros pelo "code" (estável) e mostre a "message" às pessoas.
- success_url e cancel_url em HTTPS.
- Preencha o GTIN dos produtos que tenham um: o QR Code passa a seguir o GS1 Digital Link.
- Publique a personalização da marca (Definições › Marca) e, no widget, limite os domínios se quiser.
- Respeite o limite de 100 pedidos por minuto por chave: em importações grandes, faça uma pausa quando receber 429 (rate_limited).