Transações de Cartão com Recorrência
Pré-requisitos para Ativação de Cartões
Para realizar uma transação de cartão em modalidade de crédito com recorrência, é necessário que o cartão do cliente esteja previamente cadastrado e ativado. Durante o processo de cadastro, ocorre um lançamento de valor simbólico no cartão, que será posteriormente estornado. Esse valor é utilizado para validar e ativar o cartão para transações recorrentes.
Após a ativação, o mesmo cartão pode ser reutilizado para diferentes recorrências, sem a necessidade de novas ativações.
Transações de Cartão com Recorrência
Pré-requisitos para Ativação de Cartões
Para realizar uma transação de cartão em modalidade de crédito com recorrência, é necessário que o cartão do cliente esteja previamente cadastrado e ativado. Durante o processo de cadastro, ocorre um lançamento de valor simbólico no cartão, que será posteriormente estornado. Esse valor é utilizado para validar e ativar o cartão para transações recorrentes.
Após a ativação, o mesmo cartão pode ser reutilizado para diferentes recorrências, sem a necessidade de novas ativações.
Fluxos de Operação para Recorrências
Existem dois fluxos distintos para realizar operações de recorrência, conforme a necessidade:
- Fluxo em Etapas
- Cadastro do Cartão : O cartão do cliente é cadastrado e tokenizado.
- Ativação do Cartão : É realizado o processo de ativação, utilizando o lançamento simbólico mencionado .
- Criação da Recorrência : Após a ativação, uma transação de recorrência pode ser criada, informando o ID do cartão tokenizado.
- Fluxo Direto
- Criação da Recorrência : neste fluxo, é chamada diretamente a criação da recorrência utilizando os dados do cartão informado.
- Verificação de Ativação:
- Se o cartão já estiver ativado, a recorrência será criada com o estado ACTIVE.
- Se o cartão ainda não estiver ativado, a recorrência será criada com o estado PENDING, indicando que está pendente a ativação do cartão para sua execução.
Importante: Se a data de início da recorrência for o dia atual:
- A primeira parcela será cobrada imediatamente.
- Para o fluxo direto, as parcelas restantes ficarão pendentes até que o cartão seja ativado.
Agendamentos de Recorrências
- Execução dos Agendamentos: Os agendamentos são processados diariamente entre 00:00 e 06:00. Em caso de falhas, uma nova tentativa será feita no dia seguinte. Isso continuará até que a execução seja bem-sucedida ou que a recorrência/agendamento seja cancelado.
- Notificações: Para cada tentativa, seja bem-sucedida ou não, um webhook será enviado. Consulte a seção de webhooks para mais detalhes.
Tipos de Recorrência
- LIMITED_TIMES:
- Uma quantidade fixa de transações de cartão de crédito será agendada com a frequência informada no campo recurrenceFrequency.
- O número de parcelas deve ser informado no campo numberInstallments.
- Todas as parcelas e agendamentos são criados no momento da criação da recorrência.
- INDETERMINATE:
- Nesse caso, uma transação de cartão de crédito continuará sendo gerada de acordo com a frequência informada, por um período indeterminado, até que a recorrência seja cancelada.
- Quando esta opção for selecionada, o campo numberInstallments deve ser nulo.
- Os agendamentos serão criados automaticamente no dia 1º de cada mês