Pagamentos Recorrentes (Planos e Assinaturas)

O que é

O serviço de recorrência da Zoop é um conjunto de webservices que disponibiliza operação de venda recorrente através de cartão de crédito, com base em políticas de cobrança pré-definidas, como frequência da cobrança, valor, forma de pagamento, período de carência e tolerância em caso de atraso.

Detalhes do produto

Um plano define como as assinaturas serão vendidas, renovadas e faturadas. Por exemplo, uma academia pode possuir um "Plano mensal" que é renovado automaticamente todo mês, ou um "Plano bimestral", renovado automaticamente a cada dois meses.

Assinaturas definem a relação entre um plano e um cliente, possuindo data de início e fim, representando um contrato com cobranças recorrentes baseadas nas regras estabelecidas entre o cliente e o parceiro, conforme plano vinculado.

Fluxo detalhado

Para usar o serviço de planos e assinatura, você precisa:

1. Será necessário ter um vendedor (seller) criado.

2. Aguardar a aprovação do vendedor que ocorre através do time de risco da Zoop.

3. Criar comprador (buyer).

4. Crie um novo token do cartão de crédito e guarde o ID do token devolvido, para que você possa associá-lo a um cliente existente.

5. Associe um cartão de crédito com o comprador existente, dando os identificadores de token e de clientes criados. O token do cartão será anexado ao comprador e estará pronto para ser cobrado.

6. Criar um novo plano de cobrança, com definição do valor a ser cobrado, frequência da cobrança.

7. Criar uma nova assinatura, vinculando o plano criado e associando um comprador com método de cobrança definido.

A cada vencimento da assinatura, o sistema de recorrência da Zoop irá gerar uma nova fatura, e realizar a cobrança do valor, notificando (webhook) em caso de sucesso ou falha para continuação do fluxo de aprovação/liberação dos serviços no seu sistema.

Recursos

• Cobrança de faturas avulsas caso uma assinatura esteja pendente de pagamento

• Notificação através de webhooks dos eventos de cobranças aprovadas e rejeitadas por assinatura

• Gestão de múltiplos planos e assinaturas por marketplace

• Cobrança por cartão de crédito

• Retentativa de cobrança em caso de falha

❗️

Importante.

Intervalo de cobrança

O campo "interval" funciona em conjunto com o campo "frequency", ou seja, após declarado em quanto tempo a assinatura será cobrada (mensalmente, semanalmente, anualmente ou diariamente) no campo "frequency" deve ser declarado em "interval" o número de intervalos entre a primeira cobrança e as subsequentes.

Exemplo:

"frequency": "daily", ----> Frequência diária

"interval": 30, -----> A cada 30 dias o sistema recorrente irá realizar uma cobrança

Alteração de cartão de crédito

Caso ocorra alteração do cartão do comprador por qualquer motivo, não haverá necessidade de alterar a assinatura em vigor, automaticamente o novo cartão associado será o padrão (default) para a realização das cobranças futuras.

Será possível realizar as cobranças com um cartão específico (card_id), assim ficará a critério do do comprador (Customer) escolher qual cartão cadastrado/vinculado que seja utilizado nas cobranças das próximas assinaturas. Segue o exemplo de como ficará essa requisição no ato de criar uma assinatura:

{
"plan": "plan_id",
"on_behalf_of": "seller_id",
"customer": "buyer_id",
"payment_method": "credit",
"due_date": "2022/08/08",
"currency": "BRL",
"card": "card_id"
}

❗️

Período de carência:

É possível definir o período de carência através do campo "due_date" (data definida para o início da cobrança) no ato da criação de uma assinatura (subscription), uma vez definido a data da primeira cobrança irá ocorrer exatamente no prazo definido, assim, o comprador (Customer) já poderá utilizar o serviço do vendedor (Seller) com a data já definida para a próxima cobrança sem qualquer tipo de intervenção, ou seja completamente automatizado.

Exemplo:

Ao realizar uma requisição o cliente ganhará 4 dias de carência ou "teste grátis", logo o seller irá definir a data da primeira cobrança conforme o "request" abaixo:

{
"plan": "plan_id",
"on_behalf_of": "seller_id",
"customer": "buyer_id",
"payment_method": "credit",
"due_date": "2022/08/30",
"currency": "BRL",
"card": "card_id"
}

Em um cenário, caso o comprador (Customer) queira realizar o cancelamento antes da primeira cobrança, caberá ao Marketplace disponibilizar uma opção de remoção da assinatura através da API "remover assinatura pelo identificador"** disponibilizada em nossa documentação de referencia.

🚧

Retentativa automatica

As regras da retentativa atendem o Normativo 21 da ABECS (regulatório) e aos mandantes de bandeira baseando-se nos códigos de retorno.

• Reversível: Serão permitidas as retentativas transações que poderão ser aprovadas no mesmo dia ou em dias posteriores com os mesmos dados na mensagem de autorização da transação negada.

• Irreversível: Serão irreversíveis as transações que em hipótese alguma poderão ser aprovadas no mesmo dia ou em dias posteriores caso seja submetida com as mesmas características na mensageria de autorização de uma transação negada.

Exemplo: Cartão sem fundos, fora da validade e etc...

A retentativa será realizada no máximo 9 vezes, sendo a primeira em 5 minutos, segunda 10 minutos e a terceira em 1 hora, após ocorrerão mais 5 tentativas de 3 em 3 horas totalizando o limite de 9 tentativas em 24 horas. Observando que mediante alguns retornos, a retentativa poderá ser realizada em D+1.