Github

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 na autorização de uma cobrança de Pix automático.

Status de uma autorização

NomeDescrição
CRIADAA autorização foi criada pelo recebedor (merchant) e aguarda aprovação do usuário pagador.
APROVADAA autorização foi aceita pelo usuário pagador. O agendamento das cobranças pode ser iniciado.
EXPIRADAA autorização perdeu validade porque ultrapassou o período definido.
CANCELADAA autorização foi cancelada manualmente, seja pelo recebedor ou pelo pagador.

Ciclo de vida

Cada autorização passa por um fluxo simples de status. Isso garante previsibilidade no controle, conciliação e automação do processo.


⬜️ CRIADA

A autorização foi gerada pelo PSP Recebedor em nome do recebedor e está pendente de aceite do pagador.

➡️ Pode evoluir para:

  • 🟩 APROVADA
  • 🟥 CANCELADA
  • 🟧 EXPIRADA

🟩 APROVADA

O usuário pagador aceitou a autorização. A partir deste ponto, os agendamentos de cobrança podem ser criados e executados conforme a periodicidade definida.

➡️ Pode evoluir para:

  • 🟥 CANCELADA
  • 🟧 EXPIRADA

🟧 EXPIRADA

A autorização atingiu a data final definida ou o prazo máximo de validade e foi automaticamente encerrada.

➡️ Pode evoluir para:

  • Esse é seu estado final;

🟥 CANCELADA

A autorização foi revogada, seja por iniciativa do recebedor (ex: cancelamento do serviço) ou do próprio pagador (ex: cancelamento da assinatura).

➡️ Pode evoluir para:

  • Esse é seu estado final;
⚠️

O cancelamento de uma autorização com pagamento imediato não realiza, automaticamente, o estorno do valor pago. Caso seja necessário devolver o valor ao cliente pagador, é preciso estornar, manualmente, a transação gerada.

Observação: na resposta da requisição de criação de uma autorização com pagamento imediato, é retornado o atributo IdTransaction, que identifica a transação correspondente.