Pular para o conteúdo principal
O Localpayment oferece recursos avançados de cobrança por assinatura, permitindo que você configure pagamentos recorrentes tanto para planos fixos quanto para cenários de cobrança personalizados. Esta seção oferece uma visão geral completa das funcionalidades de assinatura, fluxos de trabalho e principais considerações para integrar pagamentos recorrentes à sua configuração do Localpayment.

Países suportados e cobertura

Nosso serviço de assinatura está disponível nos principais mercados da América Latina, oferecendo suporte a pagamentos recorrentes, tanto agendados quanto sob demanda, por meio de cartões de crédito e débito. Cada país atendido possui documentação detalhada que abrange requisitos específicos, prazos de processamento e recursos disponíveis.

Casos de uso

Serviços de streaming

Gerencie assinaturas recorrentes mensais ou anuais para plataformas de conteúdo digital. Ofereça suporte a preços escalonados com diferentes conjuntos de recursos.

Produtos SaaS

Gerencie a cobrança de assinaturas de software com vários níveis de plano. Ideal para plataformas de software B2B e B2C.

Programas de associação

Automatize mensalidades de academia, taxas de clubes e pagamentos de programas de fidelidade com ciclos de cobrança flexíveis.

Serviços de utilidade pública

Configure pagamentos recorrentes para telecomunicações, internet e outras contas mensais de serviços.

Plataformas sob demanda

Ofereça suporte a pagamentos recorrentes variáveis para serviços como transporte por aplicativo, entregas e marketplaces de freelancers.

Como funciona

A Localpayment permite que os comerciantes automatizem pagamentos recorrentes com cartão e gerenciem a cobrança de assinaturas por meio de um processo seguro e simplificado. O fluxo de trabalho de assinatura envolve ações coordenadas entre seus clientes, seu aplicativo e a infraestrutura da Localpayment.
  1. Seleção de assinatura: O cliente escolhe um plano de assinatura e insere os dados de pagamento no seu checkout.
  2. Solicitação de assinatura: Seu aplicativo envia uma solicitação de criação de assinatura com dados de pagamento para a API Localpayment.
  3. Tokenização de cartão: O Localpayment tokeniza com segurança os dados do cartão e valida o método de pagamento para uso recorrente.
  4. Confirmação de assinatura: O Localpayment retorna o ID da assinatura e a confirmação para o seu aplicativo.
  5. Exibir confirmação de assinatura: O aplicativo do comerciante exibe a página de confirmação com os detalhes da assinatura e a próxima data de cobrança para o cliente.
  6. Processamento de pagamentos: O Localpayment processa automaticamente os pagamentos com cartão de acordo com o cronograma de faturamento.
  7. Notificação de status: O Localpayment envia notificações via webhook ao comerciante para pagamentos bem-sucedidos, falhas e alterações de assinatura.
Cartão - Como funciona

Pré-requisitos

Antes de configurar sua primeira assinatura, certifique-se de ter cumprido estes requisitos essenciais:

Configuração e Validação de Conta

Conclua a configuração da sua conta e valide todas as informações comerciais e financeiras necessárias. Nosso guia completo Faça seu primeiro pagamento de teste orienta você em todo o processo.

Guia de Implementação

O Localpayment permite gerenciar pagamentos recorrentes por meio de endpoints de API abrangentes que cuidam de todo o ciclo de vida da assinatura. Abaixo estão as principais operações para gerenciar assinaturas e planos.

Criar uma assinatura

Crie uma nova assinatura com um plano predefinido ou parâmetros personalizados. Compatível com modelos de cobrança agendada e sob demanda.

Atualizar uma assinatura

Modifique os detalhes da assinatura existente, incluindo valor da cobrança, frequência ou informações do cliente. Gerencie upgrades e downgrades sem problemas.

Cancelar uma assinatura

Cancele assinaturas ativas, preservando o histórico de transações. Oferece opções de cancelamento imediato ou no final do período de faturamento.

Criar um plano de assinatura

Defina planos de cobrança fixa com valores e intervalos predefinidos. Ideal para faixas de preços e níveis de associação padronizados.

Atualizar um plano de assinatura

Modifique os detalhes dos planos existentes, mantendo a associação com as assinaturas ativas. Atualize preços ou recursos para toda a sua base de clientes.

Obtenha um plano de assinatura

Obtenha informações detalhadas sobre planos de assinatura específicos, incluindo preços, ciclos de faturamento e assinaturas associadas.

Cobranças com falha e lógica de repetição

Quando uma cobrança de assinatura falha, a Localpayment oferece mecanismos de recuperação automatizados e monitoramento em tempo real para garantir a continuidade dos negócios da sua empresa e dos seus clientes.

Monitoramento de cobranças individuais

Cada tentativa de pagamento individual dentro de uma assinatura é tratada como uma transação Payin padrão. Se uma cobrança falhar (por fundos insuficientes, cartão expirado ou outros motivos), a Localpayment emite uma notificação de webhook PayIn com o código de erro específico (por exemplo, 300 - Rejeitado). Monitorar esses webhooks é a principal forma de acompanhar a saúde dos pagamentos em tempo real.

Mecanismo automatizado de novas tentativas (cobrança)

Para recuperar cobranças com falha, você pode configurar o objeto retry durante a criação da assinatura ou do plano. Esse processo automatizado de cobrança ajuda a recuperar receita sem intervenção manual:
  • retry.repetitions: O número de vezes que o sistema tentará reprocessar a cobrança com falha.
  • retry.intervalValue & retry.intervalUnit: Defina o intervalo entre cada tentativa de repetição (por exemplo, a cada 1 dia ou a cada 12 horas).

Cancelamento da assinatura devido a falhas

Se todas as tentativas de reenvio configuradas forem esgotadas e o pagamento ainda não for concluído com sucesso, a assinatura mudará automaticamente seu status de ciclo de vida para:
  • 904 - Cancelado - muitas tentativas com falha: Isso indica que a assinatura atingiu o limite de tentativas e agora está permanentemente inativa. Nenhuma outra cobrança automática será tentada para esta assinatura.

Tipos de assinatura

A Localpayment oferece dois modelos principais de assinatura para atender às diferentes necessidades de cada negócio. Escolha a opção que melhor se adapta aos seus requisitos de faturamento.

Assinaturas de Plano Fixo

Ideal para empresas com cobranças recorrentes padronizadas. Primeiro crie um plano de assinatura e, em seguida, associe-o às assinaturas dos clientes.Casos de uso comuns:
  • Planos de academia com diferentes categorias
  • planos de serviço de streaming
  • Níveis de assinatura de software
  • Taxas de adesão padronizadas

Assinaturas personalizadas

Ideal para cenários de faturamento variável, onde cada pagamento pode ter valor ou prazo diferente.Casos de uso comuns:
  • Descontos no primeiro mês com preços regulares.
  • Modelos de faturamento baseados no uso
  • Serviços sob demanda com relações recorrentes
  • cenários de preços promocionais

Operações de assinatura

Após a criação de uma assinatura, diversas operações podem ser realizadas para gerenciar seu ciclo de vida. Veja a seguir uma visão geral das operações disponíveis nos países suportados:
Última modificação em 10 de novembro de 2026