Ú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.

Charges

Um Charge representa o pagamento real que precisa ser feito na Rede de 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. Por favor, veja a tabela abaixo para obter uma visão abrangente de cada estado e o fluxo do processo.

Estado DescriçãoTransições Para Gatilho/Evento
CREATEDEstado inicial quando a cobrança é criada.
  • PENDING
  • A cobrança é iniciada, mas ainda não processada pela rede OF
PENDINGA cobrança está aguardando ação ou agendamento adicional.
  • SCHEDULED
  • SUCCEEDED
  • CANCELED
  • FAILED
  • A cobrança está agendada para processamento
  • A cobrança foi processada com sucesso na rede OF
  • A cobrança é cancelada pela rede OF enquanto está pendente
  • A cobrança falha na rede OF enquanto está pendente.
SCHEDULEDA cobrança está agendada para processamento em uma data futura.
  • SUCCEEDED
  • CANCELED
  • FAILED
  • A cobrança é processada com sucesso
  • A cobrança é cancelada enquanto agendada
  • A cobrança falha enquanto agendada.
SUCCEEDEDA cobrança foi processada com sucesso.(Estado final - sem transições adicionais)Nenhum
CANCELEDA cobrança foi cancelada.(Estado final - sem transições adicionais)Nenhum
FAILEDA cobrança falhou.(Estado final - sem transições adicionais)Nenhum

Cadastro

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

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

Autorização de Pagamento (Em Breve!)

Uma Autorização de Pagamento é o consentimento que seu usuário lhe dá para debitar (retirar 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. Por favor, veja a tabela abaixo para obter uma visão abrangente de cada estado e o fluxo do processo.

Estado DescriçãoTransições Para Gatilho/Evento
INITIALEstado 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 uma 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 uma 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 de 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. Por favor, veja a tabela abaixo para obter uma visão abrangente de cada estado e o fluxo do processo.

Estado DescriçãoTransições Para Gatilho/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 move 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 completou pagamentos agendados
  • Payment intent é cancelado.
SCHEDULE_FINISHEDO Payment Intent terminou 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