Automatize pagamentos recorrentes com gestão flexível de subscrições.
Subscrições são pagamentos recorrentes de um montante fixo, cobrados automaticamente em intervalos regulares. São perfeitas para serviços de adesão, produtos SaaS e qualquer modelo de negócio que necessite de receita recorrente previsível.
- Cobrança Automática: Pagamentos processados automaticamente conforme agendado
- Frequências Flexíveis: De diariamente a cada 3 anos
- Lógica de Repetição: Tentativas configuráveis para pagamentos falhados
- Métodos Alternativos: Método de pagamento secundário se o principal falhar
- Finito ou Ilimitado: Defina data de fim/limite de capturas ou funcione indefinidamente
- Gestão Fácil: Ative, pause, atualize ou cancele a qualquer momento
- Cartão de Crédito/Débito
- Débito Direto
| Frequência | Descrição |
|---|---|
1D | Diariamente |
1W | Semanalmente |
2W | Bi-semanal (cada 2 semanas) |
1M | Mensalmente |
2M | Bi-mensal (cada 2 meses) |
3M | Trimestralmente (cada 3 meses) |
4M | A cada 4 meses |
6M | Semestralmente (cada 6 meses) |
1Y | Anualmente |
2Y | A cada 2 anos |
3Y | A cada 3 anos |
POST /subscription
{
"frequency": "1M",
"value": 29.99,
"currency": "EUR",
"method": "cc",
"start_time": "2024-02-01 00:00",
"max_captures": 12,
"customer": {
"name": "John Doe",
"email": "john@example.com"
},
"capture": {
"descriptive": "Monthly SaaS Subscription"
},
"retries": 3,
"failover": true
}Resposta:
{
"id": "sub-123",
"status": "active",
"frequency": "1M",
"value": 29.99,
"start_time": "2024-02-01 00:00"
}Terminam após uma data específica ou número de capturas:
{
"frequency": "1M",
"value": 9.99,
"start_time": "2024-01-01",
"max_captures": 12 // 12 months
}Ou:
{
"frequency": "1M",
"value": 9.99,
"start_time": "2024-01-01",
"expiration_time": "2024-12-31 23:59" // Specific end date
}Continuam até serem canceladas manualmente:
{
"frequency": "1M",
"value": 9.99,
"start_time": "2024-01-01",
"unlimited_payments": true // No end date
}Cada subscrição cria ciclos de pagamento:
- CAPTURE_NOW: Pagamento imediato quando a subscrição é criada
- RENEWABLE: Ciclos recorrentes regulares baseados na frequência
- ONE_TIME_CHARGE: Pagamento único isolado
GET /subscription/{id}PATCH /subscription/{id}
{
"value": 39.99, // Update amount
"frequency": "1Y" // Change frequency
}PATCH /subscription/{id}
{
"status": "inactive"
}Efeito: Todos os ciclos pendentes são eliminados, sem pagamentos adicionais.
PATCH /subscription/{id}
{
"status": "active"
}Efeito: Novos ciclos criados com base na configuração atual.
DELETE /subscription/{id}Configure tentativas automáticas para pagamentos falhados:
{
"retries": 3, // Retry up to 3 times
"retry_interval": "24H" // Wait 24 hours between retries
}Como funciona:
- Tentativa de cobrança inicial
- Se falhar, repete após intervalo
- Continua até sucesso ou máximo de tentativas atingido
- Aciona fallback se configurado
Ative o failover para fornecer opções de pagamento alternativas:
{
"method": "cc", // Método principal
"failover": true
}Como funciona:
- Tenta pagamento com método principal
- Se falhar após todas as tentativas, um checkout de failover é criado
- O checkout inclui todos os métodos de pagamento ativos na sua conta
- Se o pagamento for bem-sucedido através do checkout, a subscrição continua
- Se nenhum pagamento for efetuado, o ciclo é marcado como falhado
Licença de software mensal:
{
"frequency": "1M",
"value": 49.99,
"method": "cc",
"start_time": "2024-01-01",
"unlimited_payments": true,
"retries": 3
}Taxa de adesão anual:
{
"frequency": "1Y",
"value": 199.99,
"method": "cc",
"start_time": "2024-01-01",
"unlimited_payments": true
}Plano de pagamento de 12 meses:
{
"frequency": "1M",
"value": 83.33,
"method": "dd",
"start_time": "2024-01-01",
"max_captures": 12 // Total: €999.96
}Faturação trimestral:
{
"frequency": "3M",
"value": 299.99,
"method": "cc",
"start_time": "2024-01-01",
"unlimited_payments": true
}Receba notificações para eventos de subscrição:
- subscription_created: Enviado quando o utilizador insere os seus dados de cartão e a subscrição é criada
- subscription_capture: Enviado após todas as tentativas serem feitas para uma tentativa de pagamento (seja bem-sucedida ou falhada)
- Comunicação Clara: Informe os clientes sobre os termos da subscrição antecipadamente
- Períodos de Carência: Considere períodos de carência antes de cancelar por pagamentos falhados
- Cancelamento Fácil: Torne simples para os clientes cancelarem
- Atualizar Métodos de Pagamento: Permita que os clientes atualizem detalhes de pagamento
- Preços Transparentes: Exiba claramente custo total e frequência de faturação
- Períodos de Teste: Considere testes gratuitos antes da primeira cobrança
- Cobranças Prorratizadas: Gerencie mudanças de plano no meio do ciclo com elegância
Cliente subscreve software mensal, cobrado automaticamente no 1º de cada mês, continua até cancelado.
Cliente paga taxa de adesão anual, recebe lembrete 30 dias antes da renovação, pode cancelar ou atualizar método de pagamento.
Cliente compra produto de €1000, paga €83,33/mês durante 12 meses, subscrição termina automaticamente após pagamento final.
Serviço faturado a cada 3 meses, cliente recebe fatura 7 dias antes da cobrança, pagamento auto-processado.
- Referência da API de Subscrição - Documentação completa da API
- Guia de Webhooks - Gerencie eventos de subscrição
- Checkout - Aceite subscrições via Checkout
- Guia de Tipos de Pagamento - Saiba mais sobre pagamentos de subscrição