Pagamentos Recorrentes (Planos e Assinaturas)

O que é

O serviço de recorrência da Zoop é um conjunto de webservices que disponibiliza operação de transações recorrentes 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, período de "trial" e tolerância em caso de atraso.

Detalhes do produto

Um plano define a frequência como as assinaturas serão transacionadas, 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.

As 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 nosso time de credenciamento.

3. Criar comprador (buyer).

4. Crie um novo token do cartão de crédito.

5. Associe um cartão de crédito ao comprador (customer) existente, dando os identificadores de token de cartão gerado conforme o passo 4.

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

7. Criar uma nova assinatura, vinculando ao plano criado e associando um comprador.

A cada vencimento da assinatura, o sistema de recorrência irá gerar uma nova fatura, realizando a cobrança do valor, onde será notificado através do response da transação ou evento de webhook em caso de sucesso ou falha, dando visibilidade para o marketplace continuar o fluxo de aprovação/liberação dos serviços em seu sistema.

Recursos

• Cobrança de faturas avulsas caso ocorra ausência de pagamento.

• Notificação através de eventos de webhooks de transações/faturas aprovadas ou rejeitadas através das assinaturas.

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

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

• Retentativa automática 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" deverá ser declarado o "interval" que se refere ao 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"
}

Caso de uso:

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 suspensão da assinatura através da API "Suspender uma 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 sejam submetidas com as mesmas características na mensageria de uma transação com autorizaçã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 em um período aproximadamente 24 horas. Observando que mediante alguns retornos, a retentativa poderá ser realizada em D+1.