Assinaturas e pagamentos recorrentes

DEUNA oferece suporte a pagamentos recorrentes por meio de seu próprio mecanismo de assinatura, seu sistema de cobrança existente ou uploads recorrentes em lote. Esta página explica os conceitos por trás dos pagamentos recorrentes, ajuda você a escolher uma abordagem, documenta como funciona o mecanismo de assinatura DEUNA, mostra como gerenciar planos e assinaturas no Admin e lista o que validar antes da implementação.

Conceitos-chave#

Pagamentos recorrentes, MIT e CIT

Pagamentos recorrentes cobrar cobranças repetidamente sob um acordo com um cliente. O valor pode permanecer o mesmo, como uma assinatura mensal, ou alterar, como uma conta de luz com base no uso. A cobrança automática permite que os clientes paguem contas posteriores sem concluir manualmente cada pagamento.

Um transação iniciada pelo comerciante (MIT) é um pagamento com cartão que sua empresa inicia mediante acordo prévio, sem a participação ativa do cliente nesse pagamento. Um transação iniciada pelo cliente (CIT) é um pagamento que o cliente faz ativamente, inclusive quando opta por pagar com um cartão salvo.

Recorrente descreve as coleções repetidas. O MIT descreve quem inicia um pagamento e sob que autoridade. Cobranças recorrentes automáticas de cartões são um uso comum do MIT, mas os termos não são intercambiáveis. Salvar um cartão por si só não autoriza cobranças futuras.

Por exemplo, um cliente se inscreve para uma assinatura hipotética de US$ 10 mensais. Eles pagam ativamente os primeiros US$ 10 no momento da inscrição e concordam com renovações mensais automáticas. Esse pagamento de inscrição é um CIT. No mês seguinte, sua empresa recebe a renovação acordada sem que o cliente tome nenhuma atitude: esse pagamento é um MIT. A configuração também pode salvar um cartão para uma primeira cobrança diferida, em vez de cobrar na inscrição.

Assinaturas, cobrança e processamento de pagamentos

• Assinatura: o acordo contínuo entre um cliente e um plano de produto ou serviço, incluindo preços e termos de cancelamento.
• Pagamentos recorrentes: os encargos cobrados sob esse acordo.
• Lógica de cobrança: decide quanto cobrar e quando.
• Processamento de pagamento: executa essa instrução por meio de um provedor de pagamento.

A escolha da DEUNA para processamento de pagamentos não transfere todas as responsabilidades de gerenciamento de assinaturas para a DEUNA. As políticas do cliente, impostos, faturas e prestação de serviços permanecem de sua responsabilidade, a menos que sejam integradas separadamente.

Da configuração à coleta posterior

Os fluxos de configuração e recuperação nesta página concentram-se em pagamentos recorrentes com cartão.

1. Consentimento: obtenha consentimento que identifique sua empresa e explique o valor ou cálculo, frequência ou gatilho de cobrança e termos de cancelamento.
2. Configuração do cartão: capture e tokenize o cartão, com autenticação do cliente quando necessário. A configuração pode incluir um pagamento imediato ou salvar o cartão para uma primeira cobrança diferida.
3. Decisão de cobrança: o proprietário da cobrança determina o valor e a data de vencimento de cada cobrança do contrato.
4. Processamento: DEUNA processa o pagamento.
5. Reconciliação: reconcilia cada resultado com seus registros.

DEUNADiagrama de fluxoAmpliar

Este ciclo de vida é conceitual. A abordagem escolhida determina qual sistema agenda ou envia coletas posteriores.

Reconheça seu cenário de pagamento#

Para faturas variáveis, identifique qual sistema calcula o valor e confirme se a abordagem escolhida oferece suporte a essas regras de cobrança. Ambos os cenários exigem acordo prévio e uma configuração de pagamento compatível.

Escolha uma abordagem DEUNA#

Escolha com base no local onde suas decisões de faturamento pertencem e como seu sistema fornece instruções de cobrança.

Mecanismo de assinatura DEUNA

Configure valores de cobrança, moedas, frequências, renovação automática e regras de nova tentativa. Associe clientes e métodos de pagamento a assinaturas para que o mecanismo possa agendar e processar cobranças. Veja Como funciona o mecanismo de assinatura DEUNA abaixo e Gerenciar planos e assinaturas do administrador para configuração suportada, incluindo primeiras cobranças diferidas.

O motor e sua 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 de transações de rede e os requisitos de autenticação podem limitar quais conexões são 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 coleta. A DEUNA fornece roteamento, novas tentativas elegíveis entre provedores e tratamento de pagamentos para fluxos MIT e PSD2, incluindo 3DS inicial quando necessário. Configurar estratégias de pagamento para conexões suportadas.

DEUNA também armazena identificadores de transação de rede (NTIDs) para posterior ligação ao MIT. Um token de cofre identifica as credenciais do cartão armazenadas; um NTID faz referência ao histórico de transações de rede. Nenhum dos dois substitui o consentimento do cliente e a ligação suportada depende do fornecedor e da rede.

Upload em lote recorrente

A DEUNA pode enviar coletas em lote baseadas em tokens para autorização do processador on-line, quando houver suporte. Um lote muda a forma como as instruções chegam; a autorização ainda pode ocorrer on-line para cada pagamento.

Combine o formato do lote recorrente, entrega, adequação do token, processadores e troca de resultados por pagamento com a DEUNA antes da integração.

Como funciona o mecanismo de assinatura DEUNA#

O API de Assinaturas gerencia assinaturas de clientes nos planos que você oferece. Use-o para controlar os estados da assinatura e do plano e para garantir que o faturamento, a ativação, o cancelamento e a expiração sejam executados corretamente.

Você também pode criar planos e gerenciar assinaturas no módulo Assinaturas no Admin. Veja Gerenciar planos e assinaturas do administrador para obter o guia passo a passo.

Modelo de dados

Início adiado

Um plano pode definir quando ocorre a primeira cobrança em vez de cobrar imediatamente, seja em um dia específico do mês ou em um determinado número de dias após a criação da assinatura. Apenas um modo de início diferido pode ser configurado por plano.

• Nenhuma cobrança imediata é feita
• As cobranças são agendadas automaticamente de acordo com a configuração do plano, sem chamadas adicionais de API.
• A edição do plano não é suportada e o início adiado não pode ser alterado quando o plano tiver assinaturas ativas.

Consulte Crie um plano com início diferido para ver as etapas e exemplos de configuração do administrador.

Intervalos de faturamento suportados

Estados do plano

Estados de assinatura

Ampliar

Gerencie assinaturas com a API

Criar uma assinatura

Use a Criar uma assinatura endpoint.

Lista as assinaturas

Use a Obtenha lista de assinaturas endpoint para receber todas as assinaturas de um cliente.

Atualizar uma assinatura ou cartão de pagamento

Se o cliente atualizar seu cartão, você poderá:

• Ligar Atualizar assinatura para atualizar a assinatura.
• Tente novamente a cobrança da fatura vencida.

Capture cartões de substituição por meio da captura segura de cartões para que os dados brutos do cartão permaneçam fora dos seus sistemas.

Cancelar uma assinatura

O cancelamento altera o status para canceled. Você pode especificar:

• Cancelamento no final do ciclo de faturamento atual.
• Cancelamento no final do ciclo de renovação. Por exemplo, uma assinatura mensal renovada por um ano é cancelada quando esse ano termina.
• term_end: indica o fim do ciclo atual e gera um reembolso.
• bill_date: indica o início do próximo ciclo (24 horas após term_end) e gera um reembolso.

Para as etapas administrativas correspondentes, consulte Cancelar uma assinatura no Admin.

Novas tentativas automáticas

O mecanismo de assinatura inclui um mecanismo de nova tentativa para lidar com falhas temporárias, como problemas de comunicação com processadores de pagamento durante a cobrança ou ativação da assinatura. Garante que o pagamento e a ativação sejam concluídos sem intervenção manual, mesmo com falhas intermitentes.

• Nova tentativa automática: se a cobrança ou ativação da assinatura falhar, o sistema tentará o processo novamente após um atraso.
• Espera exponencial: cada nova tentativa aumenta o tempo de espera entre as tentativas para evitar sobrecarregar o sistema.
• Limite de novas tentativas: quando as novas tentativas atingem um máximo configurável (por exemplo, seis tentativas), o sistema marca a assinatura como pausada ou cancelada (com base na sua própria configuração)
• Notificação: após tentativas fracassadas, o sistema pode notificar o cliente ou administrador sobre o status da assinatura e as falhas.

Gerenciar planos e assinaturas do administrador#

Os planos definem as condições de cobrança de uma assinatura, incluindo preço, frequência, tipo de renovação e, opcionalmente, uma data de início diferida para cobrança. Você gerencia planos e assinaturas de clientes no Assinaturas módulo no Admin.

Campos do plano

Crie um plano com início diferido

1. No menu da barra lateral, vá para Assinaturas.
2. Em Assinaturas, clique em Planos.
3. Clique Criar plano.
4. Preencha os campos gerais do plano: nome, descrição, valor, moeda, frequência e renovação.
5. No Início adiado seção, habilite o "Agendar início do faturamento" toggle.
6. Selecione como deseja definir o início do faturamento:

   • Em um dia específico do mês: a cobrança ocorrerá no mesmo dia todos os meses, independentemente de quando a assinatura foi criada.

     Exemplo: se você selecionar o dia 10 e o usuário assinar no dia 3 de outubro, a primeira cobrança será no dia 10 de outubro.

   • X dias após adquirir o plano: a cobrança ocorrerá X dias depois a assinatura é criada.

     Exemplo: se você escolher 7 dias e a assinatura começar em 5 de outubro, o período de início da assinatura será em 12 de outubro.

7. Salve as alterações clicando em Salvar plano.

O início diferido será registrado e aplicado a todas as assinaturas criadas com este plano.

Ver assinaturas

Acesse o Assinaturas guia dentro do módulo.

Você pode filtrar assinaturas por e-mail do cliente, data de criação, ou nome do plano.

Detalhes da assinatura

Clique em qualquer assinatura da lista para acessar sua visualização detalhada.

Cancelar uma assinatura no Admin

1. Vá para o Assinaturas seção no menu da barra lateral.
2. No Assinaturas guia, pesquise o cliente por e-mail ou ID.
3. Clique no ícone do menu de ação ··· e selecione Ver assinatura.
4. Na visualização detalhada, clique no botão Ações botão e selecione Cancelar.
5. Um modal será aberto com a opção de selecionar um Política de cancelamento. Existem três opções:

6. Se você escolher a opção de data específica, selecione o dia no calendário.
7. (Opcional) Adicione um motivo do cancelamento para manter a rastreabilidade.
8. Clique Confirmar cancelamento para executar a ação.

Pausar uma assinatura

1. Nos detalhes da assinatura, clique no Ações botão e selecione Pausa.
2. Um modal aparecerá onde você pode escolher o Política de pausa. Existem três opções:

3. Se você escolher a opção de data específica, selecione o dia no calendário.
4. (Opcional) Insira um motivo da pausa se você deseja registrar o contexto.
5. Clique Confirmar pausa para aplicar a ação.

Benefícios para cobranças recorrentes#

Tente novamente o tempo informado pelo comportamento

As novas tentativas orientadas por IA da DEUNA aprendem com o histórico do comportamento do comerciante e do cliente para selecionar o tempo para tentativas de recuperação elegíveis. Em comparação com um agendamento fixo de novas tentativas, isso pode ter como alvo um momento em que uma condição recuperável pode ter sido alterada. Por exemplo, uma tentativa posterior pode ser bem-sucedida após a reposição de um saldo insuficiente.

O objetivo é recuperar receitas e reduzir a rotatividade involuntária: clientes perdidos devido a falhas nos pagamentos. A aprovação não é garantida. Confirme os recursos de recuperação disponíveis e os limites do provedor ou da rede para a abordagem escolhida.

Resiliência por meio de vários provedores

O roteamento através de provedores elegíveis configurados reduz a dependência de uma única conexão de processamento. Processamento padrão pode usar um segundo processador em uma cascata de fallback. A elegibilidade depende da falha, das regras do provedor e da adequação do token para a rota alternativa. A mudança de fornecedor não repõe um saldo insuficiente.

Se uma coleção não tiver sucesso confirmado, primeiro distinga um resultado não resolvido de um resultado que permite a recuperação:

DEUNADiagrama de fluxoAmpliar

Cada caminho de recuperação depende do contrato, das regras do provedor e da configuração suportada:

• Use um fluxo de cliente compatível somente se permitido. A autenticação de cliente necessária deve retornar o cliente ao fluxo suportado; novas tentativas autônomas não podem substituí-lo.
• O substituto do provedor requer um provedor qualificado configurado.
• Uma nova tentativa de coleta posterior deve ser elegível e ocorrer no horário selecionado.
• As novas tentativas técnicas após falhas de comunicação seguem regras documentadas para o pagamento original.

Coordene a propriedade de recuperação entre o seu sistema e a DEUNA para evitar que processos independentes cobrem a mesma fatura duas vezes.

Dados de cartão menos confidenciais em seus sistemas

Use a captura de cartão da DEUNA e Cofre de Pagamentos para tokenizar credenciais e manter os dados brutos do cartão fora de seus sistemas. Isso pode reduzir os controles aplicáveis ​​sob o Padrão de Segurança de Dados da Indústria de Cartões de Pagamento (PCI DSS). A terceirização ainda deixa responsabilidades ao comerciante, incluindo supervisão do fornecedor e validação de conformidade. Veja Orientação de terceirização do PCI SSC.

Prepare-se para adoção#

Confirme o proprietário da cobrança, o fluxo de consentimento, os provedores compatíveis, a adequação do token e a política de recuperação. Se um cartão ficar inutilizável, peça ao cliente para substituí-lo por meio de captura segura de cartão.

Para resultados incertos, reconcilie o pagamento original antes de iniciar uma nova cobrança. Siga o orientação de solicitação idempotente para novas tentativas técnicas após falhas de comunicação. Use canais de resultados documentados, incluindo webhooks quando aplicável, para atualizar seus registros.

Tratamento de cancelamento

Distinguir uma solicitação de cancelamento de seu horário de vigência: imediato, final do período ou uma data especificada na política configurada.

• Interrompa novos envios a partir desse momento ou antes se a autoridade de cobrança for revogada ou expirar.
• Remova do sistema de agendamento as coleções não enviadas afetadas.
• Reconcilie pagamentos já enviados. Não presuma que o cancelamento interrompe um pagamento durante o voo; confirmar qualquer reversão ou reembolso de acordo com a política aplicável.

Validar antes do lançamento

Use casos de sandbox compatíveis. Coordene os casos indisponíveis com a DEUNA antes da implementação.

• Configuração: confirme o consentimento retido, um token adequado e a conclusão da autenticação necessária.
• Coleção: verifique se o valor corresponde à decisão de cobrança e se cada resultado está de acordo com seus registros.
• Recuperação: exercer recuperação elegível e resultados exigidos por autenticação. Confirme a política acordada e o fluxo de ação do cliente.
• Resultado incerto: verifique a reconciliação antes de outra tentativa de coleta.
• Cancelamento: verifique a política de tempo de vigência, consentimento revogado, remoção de cobranças em fila afetadas e reconciliação de pagamentos enviados.

Próximos passos#

• Mecanismo de assinatura DEUNA: configure seus planos a partir do Administrador e integrar o API de Assinaturas.
• Mecanismo de assinatura do comerciante: integrar o API de pagamento DEUNA e configurar estratégias de pagamento.
• Upload em lote recorrente: acordar a recolha e troca de resultados com a DEUNA antes de construir a integração.