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

# Visão Geral do Payin

A WEpayments oferece uma solução completa de **Payin** para empresas que operam no Brasil ou em operações cross-border. Com ela, seu site, aplicativo ou plataforma pode emitir e gerenciar pagamentos utilizando os três principais meios de pagamento do país: **Pix, Boleto Bancário e Cartão de Crédito**.

Todas as operações podem ser realizadas via API (para integração completa) ou diretamente pelo Dashboard da WEpayments. Para empresas internacionais, a solução inclui FX (câmbio) e liquidação em qualquer moeda estrangeira – tudo em uma única plataforma.

## **1. Pix**

O Pix é o sistema de pagamento instantâneo do Banco Central do Brasil (BCB). Sua principal vantagem é a liquidação em segundos, 24 horas por dia, 7 dias por semana – incluindo finais de semana e feriados.

### **Como funciona o Payin via Pix na WEpayments?**

O recebimento via Pix é feito por meio de um QR Code dinâmico (que pode ser lido com a câmera do celular) ou de um link de "copia e cola". Ambos são gerados no checkout.

### **Informações necessárias para gerar uma cobrança Pix**

Ao criar uma cobrança Pix, você deve fornecer:

* **Documento do pagador** (CPF)
* **E-mail do pagador**
* **Endereço completo** (CEP, logradouro, número, complemento, bairro, cidade, estado)
* **Valor** (mínimo de R\$ 0,01)
* **Data de vencimento**
* **Instruções adicionais** (opcional)
* **Juros e multa** (se aplicável)
* **Descontos** (se aplicável)
* **Beneficiário final** (nome, CNPJ e canal de atendimento)

### **Status do Pix no Dashboard**

| **Status**   | **Significado**                                              |
| :----------- | :----------------------------------------------------------- |
| **Created**  | Pix gerado, aguardando pagamento                             |
| **Canceled** | Não pago até a data de vencimento                            |
| **Paid**     | Pagamento confirmado                                         |
| **Credited** | Valor disponível para saque (adicionado ao Saldo Disponível) |

### **Liquidez**

A liquidação do Pix é imediata. Após a confirmação do pagamento, o valor aparece no seu Saldo Disponível – pronto para liquidação.

### **Pix Automático**

O Pix Automático é uma nova funcionalidade do sistema Pix que permite cobranças recorrentes automáticas: o cliente autoriza uma vez e os pagamentos futuros são debitados automaticamente.

**Para pagadores (clientes finais):**

* Praticidade: sem necessidade de lembrar ou repetir o pagamento todo mês.
* Controle: gerencie limites e cancelamentos diretamente pelo aplicativo do banco.

**Para recebedores (sua empresa):**

* Redução da inadimplência.
* Menor custo operacional (sem boletos ou cartões).
* Alcance: mais de 160 milhões de usuários do Pix.

> A segurança é a mesma do Pix tradicional, com suporte ao Mecanismo Especial de Devolução (MED) em caso de problemas.

## **2. Boleto Bancário**

O boleto é um meio de pagamento tradicional e amplamente utilizado no Brasil. O cliente recebe um código de barras e paga em bancos, casas lotéricas ou via internet banking.

### **Informações necessárias para gerar um boleto**

Os campos são semelhantes ao Pix, com algumas diferenças importantes:

* **Documento do pagador** (CPF)
* **E-mail do pagador**
* **Endereço completo**
* **Valor** (mínimo de **R\$ 5,00**)
* **Data de vencimento**
* **Instruções adicionais** (opcional)
* **Juros, multa e descontos** (se aplicável)
* **Beneficiário final**

### **Status do boleto no Dashboard**

| **Status**   | **Significado**                               |
| :----------- | :-------------------------------------------- |
| **Created**  | Boleto gerado, aguardando pagamento           |
| **Canceled** | Não pago até a data de vencimento             |
| **Paid**     | Pagamento confirmado, mas ainda não creditado |
| **Credited** | Valor disponível para saque                   |

> 💡 **Saldo Total vs. Saldo Disponível:**
>
> * **Saldo Total** = boletos com status "Paid" + "Credited" (previsão de receita).
> * **Saldo Disponível** = apenas boletos com status "Credited" (valor real disponível para saque).

### **Liquidez do boleto**

A liquidação ocorre em **D+1 (um dia útil)** após o pagamento. Pode levar até 4 dias até que o pagador efetue o pagamento.

## **3. Cartão de Crédito**

Disponível para todas as empresas, com funcionalidades específicas para empresas internacionais (cross-border).

### **Bandeiras aceitas**

* Visa
* Mastercard
* Elo
* Hipercard
* Diners Club
* American Express

### **Parcelamento**

É possível parcelar os pagamentos em até **12 vezes**, com valor mínimo de parcela de R\$ 5,00.

### **Modelos de liquidez**

A WEpayments oferece dois modelos de liquidação:

| **Modelo**                | **Como funciona**                                                                             | **Disponível para** |
| :------------------------ | :-------------------------------------------------------------------------------------------- | :------------------ |
| **Liquidação antecipada** | Valor creditado em **D+0 (mesmo dia)** para clientes nacionais ou **D+1** para internacionais | Sujeito a contrato  |
| **Liquidação por fluxo**  | Valor creditado em **D+30** (nacional) ou **D+31** (internacional) por parcela                | Padrão              |

### **Status do cartão de crédito no Dashboard**

| **Status**            | **Significado**                                            |
| :-------------------- | :--------------------------------------------------------- |
| **Created**           | Aguardando ação de pagamento                               |
| **Awaiting approval** | Pendente de confirmação da operadora do cartão             |
| **Confirmed**         | Pagamento confirmado pela operadora                        |
| **Credited**          | Disponível para saque                                      |
| **Canceled**          | Expirado ou cancelado pelo lojista                         |
| **Rejected**          | Dados incorretos, rejeição por fraude ou rejeição bancária |

### **Informações necessárias para emitir uma cobrança de cartão de crédito**

**Do pagador:**

* CPF
* E-mail
* Endereço completo

**Da cobrança:**

* Valor
* Data de vencimento
* URL de sucesso
* URL de falha
* URL do logotipo (para personalização do checkout)
* Descritor da fatura (nome que aparece na fatura – até 13 caracteres)

**Do produto:**

* Nome, ID de categoria, ID, quantidade, preço unitário, descrição

**Do beneficiário final:**

* Nome, CNPJ e canal de atendimento

### **Informações que o cliente deve preencher no checkout**

* Número do cartão (16 dígitos)
* Data de validade (MM/AA)
* Código de segurança (CVV)
* Nome do titular (exatamente como no cartão)
* Número de parcelas
* CPF do titular
* Aceite da política de privacidade (LGPD)

## **Tabela comparativa rápida**

| **Recurso**         | **Pix**                                           | **Boleto**                                | **Cartão de Crédito**                                        |
| :------------------ | :------------------------------------------------ | :---------------------------------------- | :----------------------------------------------------------- |
| **Liquidez**        | Imediata (segundos)                               | D+1 (dia útil)                            | D+0 a D+31 (depende do modelo)                               |
| **Disponibilidade** | 24/7                                              | Horário comercial                         | 24/7                                                         |
| **Valor mínimo**    | R\$ 0,01                                          | R\$ 5,00                                  | R\$ 5,00 por parcela                                         |
| **Parcelamento**    | Não (exceto Pix Recorrente)                       | Não                                       | Sim, até 12x                                                 |
| **Ideal para**      | Pagamentos instantâneos, valores baixos, urgência | Clientes sem cartão, pagamentos agendados | Vendas de maior valor, parcelamentos, operações cross-border |

## **Perguntas Frequentes (FAQ)**

**1. Posso usar todos os meios de pagamento ao mesmo tempo?**\
Sim. Integre uma vez via API e ofereça Pix, boleto e cartão de crédito no seu checkout.

**2. Preciso de um contrato separado para cada meio?**\
O contrato padrão da WEpayments cobre os três. Modelos de liquidação antecipada ou Pix Recorrente podem exigir um aditivo.

**3. Como acompanho os status das cobranças?**\
Pelo Dashboard (menu Cobranças ou Relatórios > Saldos). A API também retorna status em tempo real.

**4. O que acontece se um cliente pagar um boleto após o vencimento?**\
Depende da sua configuração de juros e multa. O boleto pode ser aceito com encargos adicionais ou simplesmente cancelado.

**5. Para empresas internacionais, qual meio é mais indicado?**\
Cartão de crédito com liquidação antecipada (D+1) + FX. O Pix também funciona, mas o cliente precisa ter conta bancária no Brasil.
