Tentar pagar QR Code Pix no Sandbox sem chave cadastrada = erro 404

Erro 404 ao pagar um QR Code Pix no Sandbox

Ao utilizar o endpoint abaixo no Sandbox, a API pode retornar 404 Not Found:

POST /v3/pix/qrCodes/pay

Esse erro pode ocorrer quando o QR Code foi gerado a partir de uma cobrança criada pela interface e a conta não possui uma chave Pix cadastrada.

Causa

No Sandbox, o payload do QR Code pode não ser registrado quando:

  • a conta não possui uma chave Pix válida;
  • a cobrança utiliza a integração Pix do Bradesco, que não gera esse payload no Sandbox.

Nesse cenário, embora o payload apareça na cobrança, ele não pode ser localizado pelo endpoint de pagamento.

Exemplo do fluxo com erro

Conta sem chave Pix
        ↓
Criar cobrança pela interface
        ↓
Obter o payload do QR Code
        ↓
Enviar o pagamento
        ↓
404 Not Found

Exemplo de requisição:

{
  "qrCode": {
    "payload": "payloadObtidoDaCobranca"
  },
  "value": 50
}

Como corrigir

  1. Cadastre uma chave Pix na conta Sandbox.
  2. Crie uma nova cobrança Pix após o cadastro da chave.
  3. Obtenha o novo payload do QR Code.
  4. Envie o payload para o endpoint de pagamento.
  5. Valide o resultado da operação.
Cadastrar chave Pix
        ↓
Criar nova cobrança Pix
        ↓
Obter o payload
        ↓
Pagar o QR Code
        ↓
Validar o resultado
⚠️

O cadastro da chave não corrige os QR Codes criados anteriormente.

Após cadastrar a chave Pix, gere uma nova cobrança para obter outro payload.

Como confirmar a correção

Após realizar o novo teste, confirme se:

  • o payload foi gerado após o cadastro da chave;
  • a URL e a chave de API pertencem ao Sandbox;
  • a conta pagadora possui saldo;
  • o endpoint retornou uma resposta diferente de 404;
  • o status da transação foi atualizado;
  • os Webhooks relacionados foram processados pela aplicação.

Consulte a referência de Pagamento de QR Code Pix para conhecer os parâmetros da requisição.

Conteúdos relacionados


Did this page help you?