Ciclo de vida

ℹ️
Vá para a referência da API para acessar os exemplos completos de requisição e resposta.

Para que você possa usar todos os recursos disponíveis em nossa API, é importante que antes você conheça os conceitos envolvidos no processamento de uma cobrança Pix.

Conceito	Descrição
Pix Dinâmico	Uma cobrança criada com valor, vencimento/expiração e metadados por transação. Gera um QR único (TXID único). Indicada para e-commerce e cobranças automatizadas.
Pix Estático	QR reutilizável associado a uma chave Pix. O valor pode ser informado pelo pagador ou enviado como parâmetro. Útil para pagamentos avulsos ou PDV simples.
TXID	Identificador único da cobrança Pix. Use-o para conciliação entre sua ordem interna e o pagamento recebido.
EndToEndId	Identificador único da transação gerado pelo banco do pagador. Ele acompanha o pagamento desde a origem até o destino, sendo útil para auditoria, reconciliação e identificação da transação em relatórios.
Expiração	Prazo de validade da cobrança (dinâmica). Após expirar, o QR não deve mais aceitar pagamento — o status muda para Expirado.
Liquidação / Autorização	Momento em que o pagamento é confirmado pelo arranjo Pix (SPI) e os valores são creditados na conta de liquidação do recebedor. Representado pelo status Autorizado.
Devolução Pix	Estorno (total ou parcial) iniciado pelo recebedor para devolver valores ao pagador. Representado no fluxo como Estornado.

Ciclo de vida

Cada cobrança Pix criada pela Safe2Pay evolui por um conjunto simples de status. Isso facilita a conciliação e o tratamento automático no seu sistema.

Abaixo, você encontra uma explicação detalhada de cada etapa envolvida no processo, conforme ilustrado no diagrama de mapeamento de status:

Fluxo de status da transação

⚪️ START

Cobrança Pix criada (dinâmica ou estática iniciada). O QR / payload já pode ser apresentado ao pagador.

⏳ PENDENTE

A cobrança foi emitida e aguarda pagamento.
Enquanto estiver pendente, ela pode:

Ser paga (vai para Autorizado); ou
Atingir o prazo de validade (vai para Expirado).

🟧 EXPIRADO

O prazo definido para pagamento terminou sem liquidação. QRs expirados não devem ser reapresentados.
Caso o cliente ainda queira pagar, gere nova cobrança.

✅ AUTORIZADO

O pagamento foi confirmado no arranjo Pix e creditado. A cobrança está liquidada.
Dependendo do seu contrato/fluxo de repasse, os valores podem seguir para:

Conta do merchant;
Split entre recebedores.

➡️ Pode seguir para:

Estornado (via Devolução Pix);
Fim;

🔄 ESTORNADO

Uma devolução Pix foi realizada (total ou parcial). Os valores foram retornados ao pagador.
Após o estorno, a cobrança é considerada encerrada.

⏹️ FIM

Estado terminal. A cobrança encerrou seu ciclo (expirada, liquidada, ou estornada).

Diagrama

Confira abaixo o diagrama com o mapeamento completo: