# Tipos de Pagamento

A Easypay suporta três tipos principais de pagamento para acomodar diferentes modelos de negócio e casos de uso.

## Pagamentos Únicos

Os pagamentos únicos são transações pontuais que permitem aos seus clientes pagarem uma quantia de dinheiro. Exemplos podem incluir a compra de um bem ou serviço, ou uma doação. Cada método de pagamento suportado pela easypay permite pagamentos únicos.

**Características**:

- Pagamento pontual
- Qualquer método de pagamento suportado
- Imediato ou agendado
- Pode ser criado via API ou Checkout


**Casos de Uso**:

- Compras em e-commerce
- Serviços pontuais
- Doações
- Pagamentos de faturas
- Bilhetes de eventos


**Métodos de Pagamento Suportados**:

- Cartão de Crédito/Débito
- Apple Pay
- Google Pay
- Samsung Pay
- MB WAY
- Multibanco
- Débito Direto
- IBAN Virtual


**Como Funciona**:

1. Criar um pagamento único via [API de Pagamento Único](/openapi#tag/Single-Payment) ou [Checkout](/openapi#tag/Checkout)
2. O cliente completa o pagamento usando o seu método escolhido
3. Receber uma notificação webhook quando o pagamento é concluído
4. Consultar o estado do pagamento para confirmar


**Saiba Mais**: Consulte a [Referência da API de Pagamento Único](/openapi#tag/Single-Payment) para uma implementação detalhada.

## Pagamentos Frequentes

Os pagamentos frequentes são transações repetíveis de quantias variáveis sem o cliente precisar de introduzir novamente os seus dados de pagamento. Os dados originais podem ser obtidos (*tokenizados*) através da nossa solução [Checkout](/openapi#tag/Checkout), mas cada pagamento terá que ser cobrado via [API de Pagamentos](/openapi#tag/Overview).

**Características**:

- Transações repetíveis
- Quantias variáveis
- Dados de pagamento tokenizados
- Captura manual para cada transação
- Limites opcionais de valor mínimo/máximo


**Casos de Uso**:

- Serviços sob demanda
- Quantias de faturação variáveis
- Recargas ou créditos
- Modelos de pagamento conforme utilização
- Quantias de subscrição variáveis


**Métodos de Pagamento Suportados**:

- Cartão de Crédito/Débito
- MB WAY
- Multibanco
- Débito Direto
- IBAN Virtual


**Limites de Pagamento**:
É possível limitar as quantias transferidas escolhendo valores mínimos ou máximos, quer para a quantia total das transações quer para cada transação individual.

**Como Funciona**:

1. Criar um pagamento frequente para tokenizar os dados de pagamento
2. O cliente autoriza a configuração do pagamento frequente
3. Usar o ID do pagamento frequente para capturar fundos quando necessário
4. Cada captura é uma transação separada com a sua própria quantia
5. Receber notificações webhook para cada captura


**Fluxo de Exemplo**:


```bash
# 1. Create frequent payment to tokenize details
POST /frequent
{
  "method": "cc",
  "customer": { ... },
  "max_captures": 10,
  "capture_max_value": 100.00
}

# 2. Later, capture funds when needed
POST /capture/:id
{
  "value": 45.00
}
```

**Saiba Mais**: Consulte a [Referência da API de Pagamento Frequente](/openapi#tag/Frequent-Payment) para uma implementação detalhada.

## Pagamentos de Subscrição

As subscrições são pagamentos periódicos da mesma quantia de dinheiro, configuradas através do [Checkout](/openapi#tag/Checkout) ou da nossa [API de Pagamentos](/openapi#tag/Overview).

**Características**:

- Pagamentos recorrentes
- Quantia fixa por ciclo
- Cobrança automática
- Frequência configurável (diária a cada 3 anos)
- Data de fim opcional ou limite de capturas
- Lógica de repetição para pagamentos falhados
- Suporte para método de pagamento alternativo


**Casos de Uso**:

- Subscrições mensais (SaaS, streaming, memberships)
- Renovações anuais
- Planos de parcelamento
- Doações recorrentes
- Faturas de serviços públicos


**Métodos de Pagamento Suportados**:

- Cartão de Crédito/Débito
- Débito Direto


**Opções de Frequência**:

| Frequência | Descrição |
|  --- | --- |
| `1D` | Diária |
| `1W` | Semanal |
| `2W` | Bi-semanal (a cada 2 semanas) |
| `1M` | Mensal |
| `2M` | Bi-mensal (a cada 2 meses) |
| `3M` | Trimestral (a cada 3 meses) |
| `4M` | A cada 4 meses |
| `6M` | Semi-anual (a cada 6 meses) |
| `1Y` | Anual |
| `2Y` | A cada 2 anos |
| `3Y` | A cada 3 anos |


**Ciclo de Vida da Subscrição**:

As subscrições podem ser:

- **Finitas**: Terminando numa data específica ou após um número definido de capturas bem-sucedidas
- **Ilimitadas**: Continuando indefinidamente até cancelação


**Funcionalidades Principais**:

1. **Faturação Automática**: Os pagamentos são processados automaticamente de acordo com o calendário
2. **Lógica de Repetição**: Número configurável de repetições para capturas falhadas
3. **Pagamento Alternativo**: Método de pagamento secundário opcional se o primário falhar
4. **Gestão Flexível**: Ativar, desativar ou modificar subscrições via API


**Tipos de Ciclo**:

- `CAPTURE_NOW` – Tentativa de pagamento imediato quando a subscrição é criada
- `RENEWABLE` – Ciclos recorrentes que seguem a frequência definida da subscrição
- `ONE_TIME_CHARGE` – Tentativa de pagamento única e isolada que não cria ciclos futuros


**Como Funciona**:

1. Criar uma subscrição com frequência e quantia
2. O cliente autoriza o pagamento recorrente
3. O sistema cobra automaticamente em intervalos agendados
4. Receber notificações webhook para cada cobrança
5. Pagamentos falhados são automaticamente repetidos (se configurado)


**Exemplo**:


```bash
POST /subscription
{
  "frequency": "1M",
  "value": 29.99,
  "method": "cc",
  "customer": { ... },
  "start_time": "2024-01-01",
  "max_captures": 12,  // Optional: 12 months
  "retries": 3,
  "failover": true
}
```

**Saiba Mais**: Consulte a [Referência da API de Pagamento de Subscrição](/openapi#tag/Subscription-Payment) para uma implementação detalhada.

## Escolher o Tipo de Pagamento Correto

| Requisito | Tipo Recomendado |
|  --- | --- |
| Compra pontual | Único |
| Quantias recorrentes variáveis | Frequente |
| Quantias recorrentes fixas | Subscrição |
| Cliente controla quando pagar | Único ou Frequente |
| Faturação automática | Subscrição |
| Tokenizar dados de pagamento para mais tarde | Frequente ou Subscrição |
| Necessita lógica de repetição | Subscrição |
| Quantias diferentes cada vez | Frequente |


## Comparação de Tipos de Pagamento

| Funcionalidade | Único | Frequente | Subscrição |
|  --- | --- | --- | --- |
| **Frequência** | Pontual | Sob demanda | Recorrente automático |
| **Quantia** | Fixa | Variável | Fixa |
| **Tokenização** | Não | Sim | Sim |
| **Cobrança Automática** | Não | Não | Sim |
| **Lógica de Repetição** | Não | Não | Sim |
| **Pagamento Alternativo** | Não | Não | Sim |
| **Iniciado por** | Cliente | Comerciante | Automático |


## Próximos Passos

- [Métodos de Pagamento](/docs/guides/payment-methods) - Saiba mais sobre os métodos de pagamento disponíveis
- [Autorizações e Capturas](/docs/guides/authorizations-captures) - Compreenda a autorização/captura para os métodos suportados
- [Início Rápido](/docs/quickstart) - Realize o seu primeiro pagamento
- [Referência da API](/openapi) - Documentação detalhada da API