Contexto

Ao utilizar a rota:

POST 

/v3/pix/qrCodes/pay

em ambiente sandbox, pode ocorrer um erro 404 Not Found ao tentar pagar um QR Code Pix gerado a partir de uma cobrança criada via interface, sem que haja uma chave Pix cadastrada na conta.

Esse erro acontece porque, no ambiente de testes, o payload do QR Code Pix não é registrado quando a conta não possui chave Pix válida — ou quando a cobrança foi criada com a integração Pix do Bradesco (que não gera o payload no sandbox).

Observação importante

Embora tecnicamente o erro 404 esteja correto (o payload realmente não existe no sandbox), entendemos que isso pode gerar confusão para quem está integrando com a API, já que:

• A rota usada é válida;
• O payload foi extraído corretamente da cobrança;
• A expectativa do cliente é que o QR Code funcione para testes.

Como evitar o erro

Para garantir que o teste funcione no ambiente de homologação (sandbox), é necessário cadastrar uma chave Pix na conta e gerar uma nova cobrança com QR Code associado a essa chave.

Veja a chamada para realizar um pagamento de QRCode aqui.