Pular para o conteúdo
Última atualização

Introdução

Neste artigo, fornecemos uma visão detalhada dos estados das entidades e suas transições dentro do produto de pagamentos da Belvo.

Cobranças

Uma Cobrança representa o pagamento real que precisa ser feito na Rede Open Finance do Brasil. Abaixo, descrevemos os vários estados no processo de cobrança, detalhando as possíveis transições entre esses estados e descrevendo as condições sob as quais essas transições ocorrem. Consulte a tabela abaixo para obter uma visão abrangente de cada estado e do fluxo do processo.

PENDING

SCHEDULED

SUCCEEDED

CANCELED

FAILED

PENDING

SCHEDULED

SUCCEEDED

CANCELED

FAILED

Estado DescriçãoTransições Para Gatilho/Evento
CRIADOEstado inicial quando a cobrança é criada.
  • PENDENTE
  • Cobrança é iniciada, mas ainda não processada pela rede OF
PENDENTEA cobrança está aguardando ação adicional ou agendamento.
  • AGENDADO
  • SUCEDIDO
  • CANCELADO
  • FALHOU
  • Cobrança é agendada para processamento
  • A cobrança foi processada com sucesso na rede OF
  • Cobrança é cancelada pela rede OF enquanto pendente
  • Cobrança falha na rede OF enquanto pendente.
AGENDADOA cobrança está agendada para processamento em uma data futura.
  • SUCEDIDO
  • CANCELADO
  • FALHOU
  • Cobrança é processada com sucesso
  • Cobrança é cancelada enquanto agendada
  • Cobrança falha enquanto agendada.
SUCEDIDOA cobrança foi processada com sucesso.(Estado final - sem transições adicionais)Nenhum
CANCELADOA cobrança foi cancelada.(Estado final - sem transições adicionais)Nenhum
FALHOUA cobrança falhou.(Estado final - sem transições adicionais)Nenhum

Inscrição

Uma Inscrição representa a autorização do dispositivo de um usuário na Rede Open Finance com sua instituição (necessária para Pagamentos Biométricos). Abaixo, descrevemos os vários estados no processo de Inscrição, detalhando as possíveis transições entre esses estados e descrevendo as condições sob as quais essas transições ocorrem. Consulte a tabela abaixo para obter uma visão abrangente de cada estado e do fluxo do processo.

User or institution cancels enrollment

PENDING

SUCCEEDED

FAILED

CANCELLED

User or institution cancels enrollment

PENDING

SUCCEEDED

FAILED

CANCELLED

Estado DescriçãoTransições Para Gatilho/Evento
InicialEstado Inicial da Inscrição.
  • PENDING
  • O payload da Inscrição é aceito e está aguardando confirmação pelo usuário.
PENDINGA Inscrição foi criada e agora está aguardando Autorização do usuário.
  • SUCCEEDED
  • FAILED
  • O usuário aceitou a Inscrição e ela foi registrada com sucesso na rede, bem como na instituição.
  • A Inscrição falhou, seja por erro do usuário, de rede ou da instituição.
SUCCEEDEDOs processos de Inscrição foram concluídos com sucesso.
  • CANCELED
  • O usuário cancelou a Inscrição.
FAILEDO processo de Inscrição falhou.(Estado final - sem transições adicionais)Nenhum
CANCELEDO usuário cancelou a Inscrição.(Estado final - sem transições adicionais)Nenhum

Autorização de Pagamento

Uma Autorização de Pagamento é o consentimento que seu usuário dá para que você debite (retire dinheiro de) suas contas. Abaixo, descrevemos os vários estados no processo de Autorização de Pagamento, detalhando as possíveis transições entre esses estados e descrevendo as condições sob as quais essas transições ocorrem. Consulte a tabela abaixo para obter uma visão abrangente de cada estado e do fluxo do processo.

Pix Automatico Only

Rejected Single or Scheduled Payment

AWAITING_AUTHORIZATION

FAILED

AUTHORIZED

PARTIALLY_ACCEPTED

CONSUMED

REVOKED

Pix Automatico Only

Rejected Single or Scheduled Payment

AWAITING_AUTHORIZATION

FAILED

AUTHORIZED

PARTIALLY_ACCEPTED

CONSUMED

REVOKED

Estado DescriçãoTransições Para Gatilho/Evento
INICIALEstado inicial quando a Autorização de Pagamento é criada.
  • AWAITING_AUTHORIZATION
  • FAILED
  • A rede aceita o payload da Autorização de Pagamento.
  • A rede rejeita (falha) o payload da Autorização de Pagamento.
AWAITING_AUTHORIZATIONA Autorização de Pagamento está aguardando confirmação pelo usuário na instituição.
  • AUTHORIZED
  • PARTIALLY_ACCEPTED
  • FAILED
  • O usuário confirmou a Autorização de Pagamento.
  • O usuário confirmou a Autorização de Pagamento, no entanto, a conta bancária requer autorização de outra parte.
  • A autorização falhou (o usuário pode não ter aceitado a autorização).
PARTIALLY_ACCEPTEDO usuário confirmou a Autorização de Pagamento, no entanto, a conta bancária requer autorização de outra parte. A Instituição notificará as partes relevantes para aprovar a autorização.
  • AUTHORIZED
  • FAILED
  • Todos os usuários confirmaram a Autorização de Pagamento.
  • A autorização falhou (o usuário pode não ter aceitado a autorização).
AUTHORIZEDO usuário (ou todos os usuários) confirmou a Autorização de Pagamento.
  • CONSUMED
  • REVOKED
  • FAILED
  • O período de autorização (ou número de transações) terminou.
  • O usuário revogou a autorização.
CONSUMEDO período de autorização (ou número de transações) terminou.(Estado final - sem transições adicionais)Nenhum
REVOKEDO usuário revogou a autorização.(Estado final - sem transições adicionais)Nenhum
FAILEDA Autorização de Pagamento falhou.(Estado final - sem transições adicionais)Nenhum

Payment Intents

Um Payment Intent contém todas as informações necessárias para processar um pagamento na Rede Open Finance do Brasil. Abaixo, descrevemos os vários estados no processo de Payment Intent, detalhando as possíveis transições entre esses estados e descrevendo as condições sob as quais essas transições ocorrem. Consulte a tabela abaixo para obter uma visão abrangente de cada estado e do fluxo do processo.

REQUIRES_ACTION

PROCESSING

FAILED

SUCCEEDED

SCHEDULED

CANCELED

SCHEDULE_FINISHED

REQUIRES_ACTION

PROCESSING

FAILED

SUCCEEDED

SCHEDULED

CANCELED

SCHEDULE_FINISHED

Estado DescriçãoTransições Para Disparo/Evento
Criado & ConfirmadoEstado inicial quando o Payment Intent é criado e confirmado pelo usuário no fluxo do cliente.
  • REQUIRES_ACTION
  • Payment intent é criado e confirmado.
REQUIRES_ACTIONO Payment Intent requer ação adicional.
  • PROCESSING
  • FAILED
  • Payment intent contém todas as informações necessárias
  • Payment intent falha (por exemplo, o usuário não concedeu seu consentimento no aplicativo bancário).
PROCESSINGO Payment Intent está sendo processado.
  • SCHEDULED
  • SUCCEEDED
  • CANCELED
  • FAILED
  • Payment intent passa para o estado agendado
  • Payment intent é processado com sucesso
  • Payment intent é cancelado
  • Payment intent falha.
SCHEDULEDO Payment Intent está agendado para processamento.
  • SCHEDULE_FINISHED
  • CANCELED
  • Payment intent concluiu os pagamentos agendados
  • Payment intent é cancelado.
SCHEDULE_FINISHEDO Payment Intent concluiu o processamento agendado. Usado apenas se não 100% de um agendamento foi bem-sucedido. Caso contrário, o status final é SUCCEEDED.(Estado final - sem transições adicionais)Nenhum
SUCCEEDEDO Payment Intent foi processado com sucesso.(Estado final - sem transições adicionais)Nenhum
CANCELEDO Payment Intent foi cancelado.(Estado final - sem transições adicionais)Nenhum
FAILEDO Payment Intent falhou.(Estado final - sem transições adicionais)Nenhum