Ir para produção

Antes de operar em produção, execute o checklist abaixo no sandbox. Cada item corresponde a uma situação que também ocorrerá em produção.

Checklist de homologação

1. Obter o access token e renová-lo apenas quando expirar.
2. Criar um link com Idempotency-Key, repetir a mesma chamada e verificar que o link devolvido é o mesmo. Sem a chave, cada chamada cria um novo link.
3. Tratar os erros 400, 401, 409 e 503 e, após um 503, repetir a criação com a mesma chave.
4. Cadastrar o webhook, chamar POST /v1/webhooks/teste e validar a assinatura.
5. Executar os CPFs de teste e verificar o comportamento do seu sistema em cada cenário.
6. Simular FORMALIZADA, APROVADA, RECUSADA e CANCELADA, verificar cada webhook recebido e o descarte de eventos duplicados (mesmo id).
7. Fazer o seu endpoint responder 500, verificar as retentativas e o reenvio manual.
8. Trocar o segredo (POST /v1/webhooks/segredo) e verificar que nenhum evento é rejeitado durante a troca.

Produção

Produção em breve

O ambiente de produção ainda não foi liberado. Quando for, informaremos o endereço e como ativá-lo para o seu canal. Até lá, conclua a homologação no sandbox.

Em produção, o cliente recebe o SMS e a proposta é registrada no banco. Recomendamos começar com um volume pequeno de clientes e acompanhar os webhooks.

Boas práticas

• Armazene o client_secret e o segredo do webhook em um cofre de segredos, nunca no código.
• Registre o X-Request-Id das respostas nos seus logs: o suporte usa esse identificador para localizar a requisição.
• Não registre a url do link nos logs: ela é de uso pessoal do cliente.
• Monitore as entregas com status FALHOU em GET /v1/webhooks/entregas.