Testar com segurança em produção
1
Crie uma chave só para teste
Em Dashboard → Chaves de API, crie
teste-integracao com payments:write e transactions:read. Sem transfers:write: uma chave de teste não deve conseguir enviar dinheiro.2
Use o menor valor
O mínimo de uma cobrança é R$ 1,00. Pague pelo seu próprio banco, a partir da sua própria conta.
3
Marque o que é teste
Use
externalId com prefixo claro, como teste-0001. Assim você acha no extrato e nunca colide com um pedido real.4
Revogue ao terminar
Terminou? Revogue a chave de teste. Para produção, crie outra.
O pagador informado na cobrança precisa de um CPF válido, mas não precisa ser o de quem paga o Pix. Em teste, use o seu.
Testar o webhook sem pagar nada
Você não precisa de um Pix real para testar o receptor. Assine um evento com um segredo seu e envie para o seu servidor local. Isso valida o parse, a checagem de assinatura, a deduplicação e a regra de negócio.X-NyxPag-Delivery e confira que a segunda não processa de novo. Depois altere um caractere do BODY sem refazer a assinatura e confira que o seu receptor responde 401.
Validando a assinatura
O vetor de teste com resultado conhecido e o código completo.
Eventos de transação
Payloads de exemplo para montar seus testes.
O que não dá para simular
Alguns cenários só acontecem em produção. Cubra com testes automatizados usando os payloads de exemplo da documentação:Antes de escalar
Antes de ir para produção
Chaves, idempotência, webhook, reconciliação e observabilidade.
Roteiro de integração
O passo a passo completo, da chave ao primeiro webhook.