Criação de assinatura
A criação de assinatura é a porta de entrada para o uso do sistema. Nesta etapa a assinatura pode ser criada de duas formas: Início imediato e início futuro.
O tipo de início da assinatura é determinado com base no atributo startDate enviado na requisição de criação.
Início imediato
Para assinaturas com início imediato, já são criados juntamente com a assinatura a primeira recorrência e pagamento correspondente.
No retorno da api de criação, também já são enviados os atributos de qr code pix e boleto dependendo do meio de pagamento configurado.
Para o primeiro pagamento, é possível configurar também a expiração do qr code ou do boleto
Início futuro
Para assinaturas com início futuro, somente é criado o registro da assinatura. A primeira recorrência e pagamento serão criados somente na data definida no atributo startDate.
Para os meios de pagamento pix e boleto, os devidos pagamentos serão gerados 5 dias antes da data estipulada, e, ao gerar o pagamento o merchant será notificado dessa movimentação pelo webhook de postback.
Assinaturas com inplit devem ser criadas sempre com data de pagamento futura, caso contrário o primeiro pagamento será gerado individualmente e o inplit só passará a funcionar nas recorrências subsequentes.
Assinaturas com cartão de crédito
Para assinaturas com cartão de crédito, antes da criação da assinatura, é necessário fazer a tokenização to número do cartão. Esse processo serve para proporcionar mais segurança ao trafegar dados do cartão de crédito, visto que a troca dessa informação só ocorre entre o merchant e o cofre de cartões
A documentação completa desse processo pode ser encontrada aqui
Frequência de renovação
O processo de renovação automática suporta diversos prazos de renovação, são esses:
- DAILY - Renovação diária
- WEEKLY - Renovação semanal
- BIWEEKLY - Renovação a cada duas semanas
- MONTHLY - Renovação mensal
- YEARLY - Renovação anual
Inplit
O inplit é um mecanismo para facilitar cobranças de mútiplas assinaturas para um mesmo cliente, possibilitando a geração de um único boleto ou qr code para todas as assinaturas.
Nesse processo, é configurado o atributo inplitCode, que deve ser igual em todas as assinaturas que serão cobradas juntas. Essas assinaturas podem ou não ser do mesmo merchant, desde que todos os merchants façam parte do mesmo marketplace dentro da plataforma 4all.
É necessário também que as assinaturas estejam vinculadas ao mesmo cpf.
No processo de liquidação desses valores nas contas dos merchants, os valores serão distribuídos nas contas com base no valor de cada assinatura, e as taxas correspondentes serão calculadas proporcionalmente com base no valor repassado a cada um.