01O caminho completo de um pagamento
Para o pagador, um Pix é um QR Code e uma confirmação. Para quem opera, é uma sequência de estados que precisa ser mantida consistente entre pelo menos três sistemas diferentes.
02Criação da cobrança
A cobrança é o objeto que representa a intenção de recebimento: valor, chave do recebedor, prazo de validade e informações adicionais que permitem reconhecer, depois, a que ela se refere. É nesse momento que a sua operação define como vai reencontrar aquela transação no futuro.
Grave o identificador da cobrança no seu domínio de negócio no mesmo instante em que ela é criada. Reconciliar depois, sem esse vínculo, custa muito mais caro.
03QR Code e copia e cola
O QR Code é a representação visual do payload de pagamento; o "copia e cola" é o mesmo conteúdo em texto. Nenhum dos dois é a transação em si — são apenas o veículo que leva a informação até o aplicativo do pagador.
04Identificação da transação
Uma integração madura trabalha com identificadores em camadas: o identificador da cobrança, o identificador da transação liquidada e a referência interna do seu sistema. Manter os três correlacionados é o que torna possível responder rapidamente à pergunta "esse pagamento entrou?".
05Confirmação: eventos e consulta
Há dois modos de saber que um pagamento ocorreu: receber um evento (webhook) ou consultar o status. Eles não competem — se complementam. O evento dá velocidade; a consulta dá garantia quando algo falha no caminho.
06Conciliação
Conciliar é provar que o que o seu sistema registrou corresponde ao que efetivamente entrou na conta. Sem extrato acessível por API e identificadores estáveis, a conciliação vira processo manual — e processo manual não escala.
Uma integração bem feita não é a que funciona no dia do lançamento. É a que continua explicável seis meses depois.
07Onde consultar a especificação
As definições oficiais do arranjo, incluindo a especificação técnica da API Pix, são publicadas pelo Banco Central do Brasil. Comportamentos e endpoints devem ser verificados sempre na documentação oficial vigente, não em materiais de terceiros.
Fontes e referências
Banco Central do BrasilPix — página oficialAcessar fonte →Banco Central do BrasilAPI Pix — especificação técnicaAcessar fonte →Sua operação exige mais da infraestrutura?
Conheça uma estrutura financeira preparada para acompanhar operações que precisam de estabilidade, controle e escala.
Falar com um especialista