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/payEsse 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 FoundExemplo de requisição:
{
"qrCode": {
"payload": "payloadObtidoDaCobranca"
},
"value": 50
}Como corrigir
- Cadastre uma chave Pix na conta Sandbox.
- Crie uma nova cobrança Pix após o cadastro da chave.
- Obtenha o novo payload do QR Code.
- Envie o payload para o endpoint de pagamento.
- Valide o resultado da operação.
Cadastrar chave Pix
↓
Criar nova cobrança Pix
↓
Obter o payload
↓
Pagar o QR Code
↓
Validar o resultadoO 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
Updated 9 days ago
Did this page help you?
