# 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ção | Transições Para | Gatilho/Evento | | --- | --- | --- | --- | | `CREATED` | Estado inicial quando a cobrança é criada. | - `PENDING` | - A cobrança é iniciada, mas ainda não processada pela rede OF | | `PENDING` | A 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. | | `SCHEDULED` | A 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. | | `SUCCEEDED` | A cobrança foi processada com sucesso. | (Estado final - sem transições adicionais) | Nenhum | | `CANCELED` | A cobrança foi cancelada. | (Estado final - sem transições adicionais) | Nenhum | | `FAILED` | A 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ção | Transições Para | Gatilho/Evento | | --- | --- | --- | --- | | Inicial | Estado Inicial do Cadastro. | - `PENDING` | - O payload do Cadastro é aceito e está aguardando confirmação pelo usuário. | | `PENDING` | O 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. | | `SUCCEEDED` | Os processos de Cadastro foram concluídos com sucesso. | - `CANCELED` | - O usuário cancelou o Cadastro. | | `FAILED` | O processo de Cadastro falhou. | (Estado final - sem transições adicionais) | Nenhum | | `CANCELED` | O 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ção | Transições Para | Gatilho/Evento | | --- | --- | --- | --- | | *INITIAL* | Estado 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_AUTHORIZATION` | A 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_ACCEPTED` | O 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). | | `AUTHORIZED` | O 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. | | `CONSUMED` | O período de autorização (ou número de transações) terminou. | (Estado final - sem transições adicionais) | Nenhum | | `REVOKED` | O usuário revogou a autorização. | (Estado final - sem transições adicionais) | Nenhum | | `FAILED` | A 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ção | Transições Para | Gatilho/Evento | | --- | --- | --- | --- | | Criado & Confirmado | Estado inicial quando o Payment Intent é criado e é confirmado pelo usuário no fluxo do cliente. | - `REQUIRES_ACTION` | - Payment intent é criado e confirmado. | | `REQUIRES_ACTION` | O 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). | | `PROCESSING` | O 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. | | `SCHEDULED` | O Payment Intent está agendado para processamento. | - `SCHEDULE_FINISHED` - `CANCELED` | - Payment intent completou pagamentos agendados - Payment intent é cancelado. | | `SCHEDULE_FINISHED` | O 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 | | `SUCCEEDED` | O Payment Intent foi processado com sucesso. | (Estado final - sem transições adicionais) | Nenhum | | `CANCELED` | O Payment Intent foi cancelado. | (Estado final - sem transições adicionais) | Nenhum | | `FAILED` | O Payment Intent falhou. | (Estado final - sem transições adicionais) | Nenhum |