Pular para o conteúdo principal
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.

AbordagemMelhor ajusteProprietário do faturamentoComo uma cobrança chega à DEUNA
Mecanismo de assinatura DEUNACobranças fixas ou baseadas em planos que a DEUNA deve agendarA DEUNA, de acordo com o plano configuradoO motor cria cada cobrança agendada
Mecanismo de assinatura do comercianteValores variáveis ou lógica de assinatura existenteSeu sistema de cobrançaSeu backend chama a API de pagamento da DEUNA
Upload em lote recorrenteSistemas legados que preparam arquivos de cobrançaSeu sistema de cobrança ou sistema legadoVocê fornece um lote de cobranças com tokens de segurança da DEUNA
Mecanismo de assinatura DEUNAAgendamento baseado em planos

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 comercianteSeu sistema agenda cada pagamento

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 recorrenteColeta baseada em arquivos

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.

Diagrama de fluxo
1Customer agreement2Card capture andsetup3Billing ownercalculates amountand due date4DEUNA processespayment5Merchant reconcilesfinal result
Comerciante ou clienteResultadoDEUNA
Pagamentos recorrentes, CIT e MITTerminologia central
  • 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.

Cobranças fixas e variáveisDefinir o proprietário do valor
CenárioAcordo do clienteDecisão de cobrança
Associação fixaUm valor definido em um cronograma recorrenteO plano configurado fornece o valor e o intervalo de cobrança
Fatura variávelUm valor calculado a partir do uso ou preços divulgadosO 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

Diagrama de fluxo
Activation succeedsPause policy takeseffectResumeCancellation takeseffectTerm completes1Plan available2Subscription pending3Active4Paused5Canceled6Expired or ended
Revisão ou pendenteExceção ou interrupção

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 planoCampos e intervalos de cobrança

Um plano define os termos comerciais e de agendamento usados em novas assinaturas.

ConfiguraçãoObjetivo
Nome, descrição e grupoIdentifique e organize a oferta
Código do planoMapeie o plano para o identificador no seu sistema
Valor e moedaDefina a cobrança fixa para cada ciclo de cobrança
Intervalo de cobrançaSelecione com que frequência a DEUNA agenda uma cobrança
Renovação automáticaDetermine se a assinatura se renova após seu prazo
Início adiadoAgende a primeira cobrança para uma data posterior
EstadoDetermine 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 assinaturaEstados e relacionamento com o cliente

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.

EstadoSignificado
pendingCriada, mas sua ativação ou primeira cobrança aplicável não foram concluídas
activeAtivada após o pagamento necessário ter sido concluído com sucesso
pausedCobranças agendadas futuras são suspensas até que a assinatura seja retomada
canceledO cancelamento entrou em vigor de acordo com a política selecionada
expired ou endedO prazo configurado foi concluído
Primeira cobrança adiadaDia específico ou número de dias

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çãoTentativas, tempo e estado final

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 paused ou canceled apó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.

TarefaEndpoint
Criar ou listar planosCriar um plano · Listar planos
Obter ou atualizar um planoObter um plano · Atualizar um plano
Criar ou listar assinaturasCriar uma assinatura · Lista as assinaturas
Obter ou atualizar uma assinaturaObter detalhes de uma assinatura · Atualizar uma assinatura
Substituir o cartão armazenadoAtualizar o cartão da assinatura
Pausar ou retomar o pagamentoPausa · Retomar
Cancelar uma assinaturaCancelar
Revisar eventos do ciclo de vidaObter 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 planoProcedimento de administrador
  1. Abra Assinaturas e selecione o Planos tab.
  2. Selecione Criar plano.
  3. Insira o nome, código, descrição, grupo, valor, moeda, frequência e comportamento de renovação do plano.
  4. Configurar um início adiado se a primeira cobrança deve ocorrer mais tarde.
  5. 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çõesFiltros e detalhes
  1. Abra o Assinaturas tab.
  2. Filtrar por e-mail do cliente, data de criação, plano ou status.
  3. 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 cancelarAlterações imediatas ou agendadas

Abra a assinatura, selecione Açõese escolha a operação desejada.

PolíticaEfeito
ImediatamenteAplique a pausa ou o cancelamento agora
Fim do período de cobrançaMantenha a assinatura ativa durante o período atual e, em seguida, aplique a alteração
Data específicaAgende 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.

Diagrama de fluxo
Unknown or pendingCustomer actionrequiredConfirmed failureNoEligible providerEligible later attempt1Collection result2Reconcile originalpayment3Return customer tosupported flow4Recovery allowed?5Stop automaticrecovery6Use configuredprovider fallback7Retry under oneowner and policy
ResultadoComerciante ou clienteExceção ou interrupçãoProvedor ou processadorRevisão ou pendente
  • 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.

Próximos passos#