Pagamentos recorrentes

Mantenha os pagamentos recorrentes conectados ao relacionamento com o cliente

Crie e gerencie assinaturas com cartão, acompanhe o status delas e recupere cobranças recusadas com retentativas configuráveis. Disponível hoje na Colômbia, no México e no Peru.

Fale com vendas Documentação de assinaturas

Cobrança programada ou sob demanda
Retentativas configuráveis
Cada renovação rastreável

Business Portal

Visão geral

USD

1.284.560,00

+4,2%

BRL

3.420.118,40

+12,8%

MXN

8.905.332,10

+6,1%

Volume · últimos 12 diasUSD 6,2 mi

Pay-in · Pixorder_8F2K-1043+ R$ 1.250,00
Payout · SPEIseller_0921− MX$ 18.400,00
Câmbio · BRL → USDfx_3b7q250.000,00 USD
Pay-in · Bre-Border_9A1C-2210+ COP 890.000

Disponível hoje: CO · MX · PE
Cobranças programadas e sob demanda: 2 modelos
Tentativas e intervalos configuráveis: Retentativas
Em cada cobrança: Webhook

Assinaturas com cartão

Assinaturas com retentativas configuráveis

Tudo de que você precisa para cobrar em datas programadas, recuperar cobranças recusadas e manter seus sistemas sincronizados.

Programada ou sob demanda
Cobre em um calendário fixo a partir de um plano, ou sob demanda quando o uso ou um evento exigir.
Régua de cobrança configurável
Defina quantas vezes tentar de novo uma cobrança recusada e o intervalo entre tentativas, de acordo com o seu modelo de cobrança.
Status de pagamento claro
Se todas as tentativas falharem, a assinatura é sinalizada para que sua equipe possa dar o próximo passo.
Toda cobrança é rastreável
Cada renovação é registrada como uma transação individual, com status, webhook e dados de relatório próprios.
API de planos
Crie, atualize e consulte planos com valores e intervalos de cobrança predefinidos.
Controle total
Atualize valor, frequência ou dados do pagador, troque de plano ou cancele uma assinatura via API.

Fluxo do dinheiro

Como funciona a cobrança de uma assinatura

O cartão é tokenizado uma vez; cada renovação é cobrada automaticamente, com retentativas configuráveis.

1
ClienteSua plataforma:
1Assina com cartão
A Localpayment tokeniza os dados do cartão uma única vez para uso recorrente.
2
Sua plataformaLocalpayment:
2Crie a assinatura
Plano, valor e ciclo de cobrança vinculados ao token.
3
LocalpaymentTrilho local / banco:
3Cobra a cada ciclo
A cobrança é feita no cartão tokenizado.
4
Trilho local / bancoLocalpayment:
4Aprovada ou recusada
As cobranças recusadas passam por retentativa conforme a régua que você configurar.
5
LocalpaymentSua plataforma:
5Webhook por cobrança
Sua plataforma estende ou pausa o acesso conforme o resultado.

Fluxo ilustrativo. Assinaturas com cartão estão disponíveis na Colômbia, no México e no Peru; veja as páginas de país.

Como funciona

Do cadastro à renovação

01
Crie
Escolha um plano fixo ou valor e frequência personalizados e envie POST /api/payin/subscriptions com o token do cartão. Você recebe o ID da assinatura.
02
Renove
Cada ciclo é cobrado automaticamente, ou sob demanda. Cobranças recusadas passam por retentativa conforme a sua régua, e webhooks informam cada resultado.
03
Gerencie
Atualize valor, frequência ou dados do pagador, troque de plano ou cancele via API, e acompanhe cada mudança por webhook.

Especificações

Pagamentos recorrentes em resumo

Assinaturas com cartão
Como funciona
Disponíveis na Colômbia, no México e no Peru
Detalhes
Cobrança programada ou sob demanda com cartões tokenizados
Planos
Como funciona
Crie e gerencie planos pela API
Detalhes
Defina valor, moeda e frequência de cobrança
Retentativas
Como funciona
Configure regras de retentativa para pagamentos que falharem
Detalhes
Defina o número de tentativas e o intervalo entre elas
Gestão de assinaturas
Como funciona
Atualize ou cancele assinaturas pela API
Detalhes
Gerencie valor, frequência, dados do pagador ou mudanças de plano
Relatórios
Como funciona
Acompanhe cada renovação como uma transação individual
Detalhes
Monitore o status por webhooks e relatórios
Limites e preços
Como funciona
Definidos por mercado e meio de pagamento
Detalhes
Fale com nossa equipe para mais detalhes

Recurso	Como funciona	Detalhes
Assinaturas com cartão	Disponíveis na Colômbia, no México e no Peru	Cobrança programada ou sob demanda com cartões tokenizados
Planos	Crie e gerencie planos pela API	Defina valor, moeda e frequência de cobrança
Retentativas	Configure regras de retentativa para pagamentos que falharem	Defina o número de tentativas e o intervalo entre elas
Gestão de assinaturas	Atualize ou cancele assinaturas pela API	Gerencie valor, frequência, dados do pagador ou mudanças de plano
Relatórios	Acompanhe cada renovação como uma transação individual	Monitore o status por webhooks e relatórios
Limites e preços	Definidos por mercado e meio de pagamento	Fale com nossa equipe para mais detalhes

As assinaturas com cartão estão disponíveis atualmente na Colômbia, no México e no Peru. Os recursos específicos e as condições comerciais são confirmados durante o onboarding.

Operações

Renovações que o financeiro consegue rastrear

Como cada renovação é registrada como uma transação individual, as assinaturas com cartão são conciliadas como os pagamentos únicos: mesmos identificadores, mesmos webhooks, mesmos relatórios.

Seu externalId e o nosso internalId em cada cobrança
Webhooks assinados com HMAC-SHA256 para cobranças, falhas e mudanças
Gestão de chargebacks de assinaturas
Relatórios do Business Portal com exportação em XLS

webhooks · entregas

09:41:02.11409:41:02PayIn100 INPROGRESS20084 ms
09:41:05.90209:41:05PayIn200 COMPLETED20091 ms
09:42:18.33009:42:18PayOut100 INPROGRESS20077 ms
09:42:40.01809:42:40PayOut200 COMPLETED20088 ms
09:43:00.55109:43:00VirtualAccount200 COMPLETED20080 ms

POST https://example-merchant.com/webhooks/localpayment
x-Signature: HMAC-SHA256 3f9a1c0e…b47e2b
{ "transactionType": "PayIn", "transactionFlow": "DIRECT",
  "data": { "externalId": "order_8F2K-1043",
    "status": { "code": "200", "description": "COMPLETED" } } }

Para desenvolvedores

Crie uma assinatura com uma única chamada

Envie o plano, o token do cartão e a sua régua de retentativas. A Localpayment executa cada cobrança a partir daí e informa por webhook.

Planos fixos (planId) ou valores e frequências personalizados
retry.repetitions, retry.intervalValue e retry.intervalUnit
Atualize ou cancele via API a qualquer momento

Documentação de assinaturas

# Ilustrativo: campos simplificados; veja docs.localpayment.com para o contrato completo
curl -X POST https://api.stage.localpayment.com/api/payin/subscriptions \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "paymentMethod": { "type": "CreditCard", "code": "1900", "flow": "DIRECT" },
    "externalId": "5d7c2a90-0000-4000-8000-000000000031",
    "country": "COL",
    "currency": "COP",
    "planId": "<your-plan-id>",
    "accountNumber": "<your-account-number>",
    "conceptCode": "0001",
    "merchant": { "type": "COMPANY", "name": "Comercio Ejemplo S.A.S." },
    "payer": {
      "type": "INDIVIDUAL",
      "name": "Andrés",
      "lastname": "Gómez",
      "document": { "type": "CC", "id": "1000000000" },
      "email": "andres.gomez@example.com"
    },
    "card": { "token": "<card-token>" },
    "retry": { "repetitions": 3, "intervalValue": 1, "intervalUnit": "day" }
  }'

Casos de uso

Feito para negócios com cobrança recorrente

Streaming e conteúdo digital
Planos mensais ou anuais, com diferentes níveis de acesso.
Streaming e conteúdo digital —
SaaS
Planos de software B2B e B2C, com upgrades e downgrades via API.
SaaS —
Associações e clubes
Academias, mensalidades de clubes e programas de fidelidade com ciclos de cobrança flexíveis.
Serviços essenciais e telecom
Pagamentos recorrentes de internet, telefonia móvel e outros serviços mensais.

Perguntas frequentes

Onde as assinaturas com cartão estão disponíveis?

Na Colômbia, no México e no Peru, com modelos programados e sob demanda.

O que acontece quando uma renovação falha?

Tentamos de novo conforme as regras que você configurar. Se todas as tentativas falharem, a assinatura é sinalizada e nenhuma nova cobrança automática é feita, para que sua equipe possa dar o próximo passo.

Posso alterar uma assinatura depois que ela começa?

Sim. Você pode atualizar valor, frequência ou dados do pagador, trocar de plano ou cancelar via API.

As renovações aparecem nos meus relatórios?

Sim. Cada renovação é registrada como uma transação individual, então aparece nos seus relatórios e webhooks como qualquer outro pagamento.

Posso cobrar assinaturas com métodos de pagamento locais?

Hoje as assinaturas são com cartão, na Colômbia, no México e no Peru.

Na mesma API

Mantenha seus assinantes renovando

Conte como você cobra e em quais mercados vende: ativamos assinaturas com cartão na Colômbia, no México e no Peru.

Fale com vendas Documentação de assinaturas

Mantenha os pagamentos recorrentes conectados ao relacionamento com o cliente

Assinaturas com retentativas configuráveis

Programada ou sob demanda

Régua de cobrança configurável

Status de pagamento claro

Toda cobrança é rastreável

API de planos

Controle total

Como funciona a cobrança de uma assinatura

Do cadastro à renovação

Crie

Renove

Gerencie

Pagamentos recorrentes em resumo

Renovações que o financeiro consegue rastrear

Crie uma assinatura com uma única chamada

Feito para negócios com cobrança recorrente

Streaming e conteúdo digital

SaaS

Associações e clubes

Serviços essenciais e telecom

Perguntas frequentes

Na mesma API

Cartões

Checkout

Conciliação e relatórios

Mantenha seus assinantes renovando

Baixe o seu exemplar