> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão geral das assinaturas

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.

| País | Tipos de assinatura |
| - | :-: |
| **[Colômbia](https://docs.localpayment.com/pt-br/docs/colombia.md)** | Programado e sob demanda |
| **[México](https://docs.localpayment.com/pt-br/docs/mexico.md)** | Programado e sob demanda |
| **[Peru](https://docs.localpayment.com/pt-br/docs/peru.md)** | Programado e sob demanda |

***

## Casos de uso

> [card] 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.

> [card] 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.

> [card] Programas de associação
>
> Automatize mensalidades de academia, taxas de clubes e pagamentos de
> programas de fidelidade com ciclos de cobrança flexíveis.

> [card] Serviços de utilidade pública
>
> Configure pagamentos recorrentes para telecomunicações, internet e outras
> contas mensais de serviços.

> [card] 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](https://mintcdn.com/localpayment-1fee3d41/oFZuSE0fcOk5ECyA/images/docs/ccceeef991d549f99b2b2ab4c5f7755248b22f9597af8c1ff7510c37f596fd89-Subscriptions-overview.png?fit=max\&auto=format\&n=oFZuSE0fcOk5ECyA\&q=85\&s=487947a140015f03a722378779a6f068)

***

## Pré-requisitos

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

> [card] [Configuração e Validação de Conta](https://docs.localpayment.com/docs/make-your-first-test-payment.md)
>
> 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.

> [card] [Criar uma assinatura](https://docs.localpayment.com/pt-br/docs/create-a-subscription.md)
>
> Crie uma nova assinatura com um plano predefinido ou parâmetros personalizados. Compatível com modelos de cobrança agendada e sob demanda.

> [card] [Atualizar uma assinatura](https://docs.localpayment.com/pt-br/docs/update-a-subscription.md)
>
> Modifique os detalhes da assinatura existente, incluindo valor da cobrança, frequência ou informações do cliente. Gerencie upgrades e downgrades sem problemas.

> [card] [Cancelar uma assinatura](https://docs.localpayment.com/pt-br/docs/cancel-a-subscription.md)
>
> Cancele assinaturas ativas, preservando o histórico de transações. Oferece opções de cancelamento imediato ou no final do período de faturamento.

> [card] [Criar um plano de assinatura](https://docs.localpayment.com/pt-br/docs/create-a-subscription-plan.md)
>
> Defina planos de cobrança fixa com valores e intervalos predefinidos. Ideal para faixas de preços e níveis de associação padronizados.

> [card] [Atualizar um plano de assinatura](https://docs.localpayment.com/pt-br/docs/update-a-subscription-plan.md)
>
> 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.

> [card] [Obtenha um plano de assinatura](https://docs.localpayment.com/pt-br/docs/get-subscription-plan.md)
>
> 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.

> [card] 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

> [card] 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:

| País | [Atualizações do Plano](https://docs.localpayment.com/pt-br/docs/update-a-subscription-plan.md) | [Atualizações de assinatura](https://docs.localpayment.com/pt-br/docs/update-a-subscription.md) | [Cancelamentos](https://docs.localpayment.com/pt-br/docs/cancel-a-subscription.md) | [Estorno](https://docs.localpayment.com/pt-br/docs/chargebacks.md) | [Webhooks](https://docs.localpayment.com/pt-br/docs/webhooks.md) |
| - | :-: | :- | :- | :- | :- |
| **[Colômbia](https://docs.localpayment.com/pt-br/docs/colombia.md)** | ✔ | ✔ | ✔ | ✔ | ✔ |
| **[México](https://docs.localpayment.com/pt-br/docs/mexico.md)** | ✔ | ✔ | ✔ | ✔ | ✔ |
| **[Peru](https://docs.localpayment.com/pt-br/docs/peru.md)** | ✔ | ✔ | ✔ | ✔ | ✔ |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.