Máquina de Estados do Pix Automático
Assinatura (Subscription)
A assinatura é a entidade mais abrangente, no caso do pix automático, o seu tipo é PIX_RECURRING
. A assinatura poderá ter os seguintes status:
ACTIVE
: Assinatura ativa e criando novas parcelas nas datas pré definidas.COMPLETED
: Assinatura concluída e não criará novas parcelas. (Especificadamente quando a assinatura tem uma data final).EXPIRED
: Possui uma parcela que foi expiradaINACTIVE
: Assinartura cancelada
Pix Automático (PixRecurring)
Quando a assinatura é do tipo PIX_RECURRING
, ela terá um novo status dentro do objeto pixRecurring
. Isso é necessário porque o status do Pix Automático é alterado de mandeira independente da assinatura.
O status sempre se inicia com CREATED
, após o consumidor aprovar o QR Code no aplcativo do banco ele muda de status para APPROVED
, nesse cenário, ele já comecará a criar as cobranças.
Caso o consumidor deseja cancelar a assinatura, ele pode cancelar a qualquer momento no aplicativo do banco. Nesse caso ele mudará de status para REJECTED
.
Caso você deseja cancelar a assinatura, o status irá ser alterado para CANCELED
.
CREATED
: Status padrão de quando é criadoAPPROVED
: Aprovado pelo consumidor e poderá ser criado as cobrançasCANCELED
: Cancelado pelo usuárioREJECTED
: Autorização removida pelo consumidor
Parcela (Installment)
SCHEDULED
: Status padrão de quando é criada. Esse status significa que ela está agendada, e sua cobrança ocorerá na data prevista.ACTIVE
: Ela é movida para esse status após estar agendada. Nesse status a COBR já foi criada e aprovado pelo banco do consumidor.COMPLETED
: Quando o usuário pagou a cobrança que está relacionadaEXPIRED
: Quando a cobrança passou do prazo de vencimento e não teve pagamentoCANCELED
: Quando a parcela foi cancelada, pode ocorrer manualmente ou devido a um erro ao gerar a cobrança
As primeiras parcelas são geradas junto com a assinatura, com a data prevista definida pelo dayGenerateCharge
com o status SCHEDULED
. Em caso de assinatura mensal, elas são geradas sempre no mesmo dia, se ela for criada no dia 31 e o próximo mês não tiver essa data, ela será ajustada para o último dia do mês.
Cobrança Recorrente (CobR)
As cobranças que serão criadas para debitar automaticamente do cliente.
Por padrão ele é criado 4 dias antes da data de cobrança. Após ser criado, é feita uma requisição para o banco do consumidor para ele ser aprovado ou rejeitado.
CREATED
: Status padrão de quando é criadaACTIVE
: Cobrança aceita pelo banco do consumidorCONCLUDED
: Cobrança realizada com sucessoFAILED_TRY
: Tentativa de cobrança falhouREJECTED
: Cobrança rejeitada pelo banco do consumidor, ela só mudará para esse status em duas situações:- Após uma tentativa falhar e a cobrança atingir sua data de expiração, caso o retryPolicy seja
THREE_RETRIES_7_DAYS
- Após uma tentativa falhar e a cobrança não ser paga na data determinada, caso o retryPolicy seja
NON_PERMITED
- Após uma tentativa falhar e a cobrança atingir sua data de expiração, caso o retryPolicy seja
CANCELED
: Cobrança cancelada
Retentativa Cobrança Recorrente (CobRTry)
Sempre que uma cobrança for criada, também será criada uma tentativa de cobrança, caso ela falhe, dependendo da opção definida na assinatura (retryPolicy
), poderão ser feitas novas tentativas de cobrança.
THREE_RETRIES_7_DAYS
serão feitas até 3 retentativas: a primeira um dia após data da cobrança, outra na data intermediária entre a data da cobrançca e data de expiração, e a última tentativa será feita na data de expiração.NON_PERMITED
não serão feitas retentativas.
Cada retentativa possui um status próprio, somente é possível realizar uma nova retentativa caso a última seja rejeitada
REQUESTED
: Status padrão de quando é criada, simboliza que foi feito uma nova tentativa de cobrançaSCHEDULED
: Quando a tentativa de cobrança é aceita com sucesso pelo bancoPAID
: Quando a tentativa de cobrança é paga pelo bancoREJECTED
: Quando a tentativa de cobrança é rejeitada pelo banco, nessa situação poderão ser feitas novas tentativas