1. Guarde o vínculo com o pedido
Ao criar uma cobrança, mantenha o identificador retornado pela API associado ao pedido no seu sistema. Esse vínculo permite localizar a mesma venda no painel, em uma consulta ou em um webhook.
Apresente ao comprador o código Pix retornado pela integração. Gerar esse código não confirma o pagamento e não deve, sozinho, liberar a entrega.
2. Envie os dados que sua operação precisa
Informe os campos exigidos pela documentação e envie metadados úteis, como a referência do produto ou do pedido. Dados de campanha precisam ser preservados no checkout e enviados na criação da cobrança.
No painel, campos sem informação não significam necessariamente erro: podem não ter sido enviados ou armazenados naquela transação. Confira o pedido original da integração antes de tentar completar informações.
3. Confirme antes de entregar
Receba a notificação de pagamento e consulte a cobrança quando precisar verificar seu estado atual. Relacione o identificador, o valor e o pedido esperado antes de atualizar a venda.
Um print de comprovante ou o retorno do comprador ao site não substitui a confirmação da transação. Registre no seu sistema que a entrega já foi processada para evitar duplicidade.
4. Investigue uma cobrança pendente
Abra os detalhes da transação e confira situação, valor e horários. Se seu sistema e o painel divergirem, verifique a consulta da API e os registros de webhook.
Não invente um prazo de expiração quando ele não estiver disponível na resposta. Para dúvidas sobre uma transação, informe ao suporte seu identificador, evitando compartilhar credenciais.