Pagamentos Recorrentes (Planos e Assinaturas)

O que é#

Detalhes do produto#

Fluxo detalhado#

Recursos#

❗️ 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.