Emissão e recebimento são etapas diferentes
A criação da cobrança entrega uma forma de pagar. Ela pode ter sido criada com sucesso e continuar pendente. O cliente ainda precisa realizar o Pix e o recebimento precisa ser validado.
Uma imagem de comprovante ou uma página de sucesso no navegador não é uma fonte confiável para baixar o pedido automaticamente. A confirmação deve vir do backend.
Consulte ou receba um evento validado
A integração consulta a cobrança pelo identificador e aguarda PAID. Também pode receber um evento charge.paid, desde que valide a assinatura e o vínculo com o pedido.
Guarde o identificador da cobrança e a referência do pedido desde a emissão. Isso evita depender de uma busca por nome ou de uma lista limitada de registros recentes.
Quando houver divergência, investigue antes de cobrar de novo
Consulte o estado atual e o histórico de eventos. Se houve timeout, preserve a chave de idempotência. Repetir a emissão com outra chave pode gerar uma segunda cobrança para a mesma venda.
O resultado deve ser verificável: qual cobrança foi paga, em que horário e a qual pedido ela corresponde. Essa clareza sustenta uma operação com menos retrabalho.
Confira os campos e regras atuais antes de integrar. Seu cliente sempre paga a cobrança por Pix.
Abrir documentação ↗
