Assinaturas e pagamentos recorrentes
Selecione quem é responsável pela cobrança recorrente, implemente o motor de assinaturas da DEUNA e gerencie planos, cobranças, tentativas e alterações no ciclo de vida de forma segura.
Nesta página
A DEUNA suporta pagamentos recorrentes através do motor de assinaturas da DEUNA, um sistema de cobrança de propriedade do comerciante, ou uploads em lote recorrentes. Comece selecionando quem decide o que cobrar e quando; essa decisão determina o modelo de integração e operação.
Selecione quem é responsável pela cobrança#
O responsável pela cobrança calcula cada valor e decide quando ele deve ser cobrado. O processamento de pagamentos executa essa instrução. Escolha um proprietário primário para evitar que dois sistemas enviem a mesma cobrança.
| Abordagem | Melhor ajuste | Proprietário do faturamento | Como uma cobrança chega à DEUNA |
|---|---|---|---|
| Mecanismo de assinatura DEUNA | Cobranças fixas ou baseadas em planos que a DEUNA deve agendar | A DEUNA, de acordo com o plano configurado | O motor cria cada cobrança agendada |
| Mecanismo de assinatura do comerciante | Valores variáveis ou lógica de assinatura existente | Seu sistema de cobrança | Seu backend chama a API de pagamento da DEUNA |
| Upload em lote recorrente | Sistemas legados que preparam arquivos de cobrança | Seu sistema de cobrança ou sistema legado | Você fornece um lote de cobranças com tokens de segurança da DEUNA |
Mecanismo de assinatura DEUNA
Configure o valor, a moeda, a frequência, o comportamento de renovação, a opção de cobrança inicial adiada e a política de repetição. Associe um cliente e um método de pagamento suportado a um plano; a DEUNA então agenda as cobranças.
O motor e a classificação de pagamento recorrente devem estar habilitados para o comerciante e a loja necessários. O suporte do processador, a portabilidade do token, a ligação da transação na rede e os requisitos de autenticação podem limitar as conexões elegíveis para cobranças posteriores.
Mecanismo de assinatura do comerciante
Mantenha sua lógica de faturamento e use o API de pagamento DEUNA para cada cobrança. Seu sistema continua responsável por calcular os valores, aplicar o acordo, agendar as cobranças e evitar duplicidades.
A DEUNA pode manter identificadores de transações na rede suportados para ligação posterior de transações iniciadas pelo comerciante. Um token de "vault" identifica credenciais de cartão armazenadas; um identificador de transação na rede referencia o histórico de transações. Nenhum substitui o consentimento do cliente, e a portabilidade depende do provedor e da rede.
Upload em lote recorrente
Use este modelo quando uma plataforma existente prepara cobranças recorrentes em arquivos. Concorde com a DEUNA sobre o formato em lote, a entrega segura, a adequação do token, os processadores elegíveis e a troca de resultados por pagamento antes da implementação.
O recebimento em lote não é aprovação de pagamento, e a autorização não é liquidação. Reconcilie cada item com o resultado final do pagamento.
Ciclo de vida compartilhado de pagamento recorrente#
Todas as três abordagens precisam da mesma base: acordo do cliente, credencial reutilizável suportada, decisão explícita de cobrança, processamento de pagamento e reconciliação.
Pagamentos recorrentes, CIT e MIT
- Pagamento recorrente: uma cobrança coletada repetidamente de acordo com um contrato. O valor pode ser fixo, como uma assinatura, ou variável, como cobrança com base no uso.
- Transação iniciada pelo cliente (CIT): um pagamento que o cliente efetua ativamente, incluindo o primeiro pagamento concluído durante o registro.
- Transação iniciada pelo comerciante (MIT): um pagamento posterior com cartão que sua empresa inicia sob o acordo anterior, sem que o cliente participe ativamente desse pagamento.
"Recurring" define o padrão de cobrança; "MIT" define quem inicia o pagamento e sob qual autoridade. Salvar um cartão sozinho não autoriza cobranças futuras.
Por exemplo, um cliente pode efetuar o primeiro pagamento para uma assinatura mensal como um "MIT" e autorizar renovações posteriores. Uma renovação automática subsequente também é um "MIT". A configuração pode tokenizar o cartão para uma primeira cobrança adiada.
Consentimento e autenticação
Mantenha um acordo que identifique sua empresa e explique o valor ou cálculo, a frequência de cobrança ou o gatilho, e os termos de cancelamento. Capture e tokenize o cartão através de um fluxo suportado, com autenticação do cliente, quando necessário.
Sob a Segunda Diretiva de Serviços de Pagamento (PSD2), "MITs" qualificados podem estar fora da autenticação forte do cliente (SCA), mas isso não é uma exceção geral para cobranças recorrentes. A configuração remota requer SCA nas condições aplicáveis. Consulte o Orientação do MIT da EBA e configurar 3D Seguro (3DS) onde necessário.
Cobranças fixas e variáveis
| Cenário | Acordo do cliente | Decisão de cobrança |
|---|---|---|
| Associação fixa | Um valor definido em um cronograma recorrente | O plano configurado fornece o valor e o intervalo de cobrança |
| Fatura variável | Um valor calculado a partir do uso ou preços divulgados | O sistema de cobrança do comerciante calcula o valor antes de cada cobrança |
Se o valor puder mudar, confirme qual sistema calcula e que o modelo selecionado suporta essas regras.
Mecanismo de assinatura DEUNA#
O motor DEUNA organiza a cobrança recorrente em torno de planos e assinaturas de clientes.
Visão geral do ciclo de vida
As transições aplicáveis dependem do plano, da política de cancelamento ou pausa e da configuração da conta. Reconcilie o resultado do pagamento antes de tratar uma pending assinatura como ativa.
Referência do plano
Um plano define os termos comerciais e de agendamento usados em novas assinaturas.
| Configuração | Objetivo |
|---|---|
| Nome, descrição e grupo | Identifique e organize a oferta |
| Código do plano | Mapeie o plano para o identificador no seu sistema |
| Valor e moeda | Defina a cobrança fixa para cada ciclo de cobrança |
| Intervalo de cobrança | Selecione com que frequência a DEUNA agenda uma cobrança |
| Renovação automática | Determine se a assinatura se renova após seu prazo |
| Início adiado | Agende a primeira cobrança para uma data posterior |
| Estado | Determine se o plano está disponível para novas assinaturas |
Os intervalos de cobrança suportados são DAILY, WEEKLY, BIWEEKLY, THIRTY_DAYS, SIXTY_DAYS, NINETY_DAYS, MONTHLY, BIMESTRIAL, QUARTERLY, ANNUAL, BIENNIAL, TRIANNUALe BIANNUAL.
Referência da assinatura
Uma assinatura conecta um cliente a um plano e registra seu ciclo de vida, método de pagamento, datas de cobrança e transações processadas.
| Estado | Significado |
|---|---|
pending | Criada, mas sua ativação ou primeira cobrança aplicável não foram concluídas |
active | Ativada após o pagamento necessário ter sido concluído com sucesso |
paused | Cobranças agendadas futuras são suspensas até que a assinatura seja retomada |
canceled | O cancelamento entrou em vigor de acordo com a política selecionada |
expired ou ended | O prazo configurado foi concluído |
Primeira cobrança adiada
Um plano pode agendar o primeiro débito em vez de debitar imediatamente. Escolha um dos modos suportados:
- Dia específico do mês: débito no dia configurado do calendário. Por exemplo, uma assinatura criada em 3 de outubro com o dia 10 selecionado, o primeiro débito será em 10 de outubro.
- Número de dias após a aquisição: débito após o atraso configurado. Por exemplo, uma assinatura criada em 5 de outubro com um atraso de 7 dias, o primeiro débito será em 12 de outubro.
O cartão é tokenizado quando a assinatura é criada, mesmo que o débito comece mais tarde. A regra de atraso se aplica a assinaturas criadas a partir desse plano.
Política de repetição
Configure o comportamento de repetição a partir da Configuração da assinatura na aba "Admin":
- número máximo de tentativas;
- intervalo de repetição e sua unidade (minutos, horas ou dias);
- retrocesso linear ou exponencial; e
- transição para
pausedoucanceledapós o número de tentativas configurado esgotado.
A visualização no Admin mostra o cronograma de tentativas calculado antes de salvar. Coordene a recuperação com qualquer processo de repetição do lado do comerciante para que a mesma fatura não seja cobrada duas vezes.
Use a API de Assinaturas#
Use a autenticação com backend de chave privada para operações de assinatura. A API gerencia planos, assinaturas de clientes, alterações de cartão, ações de ciclo de vida e histórico.
| Tarefa | Endpoint |
|---|---|
| Criar ou listar planos | Criar um plano · Listar planos |
| Obter ou atualizar um plano | Obter um plano · Atualizar um plano |
| Criar ou listar assinaturas | Criar uma assinatura · Lista as assinaturas |
| Obter ou atualizar uma assinatura | Obter detalhes de uma assinatura · Atualizar uma assinatura |
| Substituir o cartão armazenado | Atualizar o cartão da assinatura |
| Pausar ou retomar o pagamento | Pausa · Retomar |
| Cancelar uma assinatura | Cancelar |
| Revisar eventos do ciclo de vida | Obter histórico de assinaturas |
Gerencie no painel de administração#
Abra Assinaturas no DEUNA Admin. O usuário precisa ter acesso ao módulo de Assinaturas; criar um plano também requer a permissão "Criar plano".
Criar um plano
- Abra Assinaturas e selecione o Planos tab.
- Selecione Criar plano.
- Insira o nome, código, descrição, grupo, valor, moeda, frequência e comportamento de renovação do plano.
- Configurar um início adiado se a primeira cobrança deve ocorrer mais tarde.
- Revisar as configurações e selecionar Salvar plano.
Verifique se o plano salvo está ativo e aparece na lista de Planos antes de atribuir novas assinaturas.
Visualizar assinaturas e transações
- Abra o Assinaturas tab.
- Filtrar por e-mail do cliente, data de criação, plano ou status.
- Abra uma assinatura para revisar os detalhes do cliente, o plano associado, datas de cobrança, valor, método de pagamento, transações e histórico de ciclo de vida.
Utilize os resultados da transação – e não apenas a presença de uma linha de assinatura – para verificar se a cobrança foi bem-sucedida.
Pause, retomar ou cancelar
Abra a assinatura, selecione Açõese escolha a operação desejada.
| Política | Efeito |
|---|---|
| Imediatamente | Aplique a pausa ou o cancelamento agora |
| Fim do período de cobrança | Mantenha a assinatura ativa durante o período atual e, em seguida, aplique a alteração |
| Data específica | Agende a alteração para a data futura selecionada |
Adicione uma justificativa, se disponível, para preservar o contexto operacional. Uma assinatura pausada pode ser retomada a partir do mesmo menu de Ações. Após qualquer ação, verifique o status e a data de efetividade nos detalhes da assinatura.
Recupere cobranças malsucedidas com segurança#
Primeiro, distinga um resultado não resolvido de uma falha confirmada. Nunca inicie uma nova cobrança enquanto o pagamento original ainda possa ser concluído.
- A autenticação do cliente deve retornar o cliente para o fluxo suportado; tentativas repetidas sem supervisão não substituem isso.
- A falha do provedor requer uma conexão elegível e um credencial que possa ser usado nessa rota.
- Uma nova tentativa deve estar em conformidade com o acordo com o cliente, as regras do processador e a política de repetição configurada.
- Para falhas de comunicação, reconcilie o pagamento original e siga as regras técnicas de repetição documentadas.
Utilize a captura de cartão da DEUNA e Cofre de Pagamentos para tokenizar credenciais e manter os dados brutos do cartão fora dos sistemas do comerciante. A terceirização da captura de cartão não elimina as responsabilidades de conformidade do comerciante.
Validar antes do lançamento#
Para resultados assíncronos, utilize webhooks e recupere o recurso original antes de atualizar seus registros.