> ## 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.

# Conversion Fee: como funciona a cobrança automática para operações crossborder

Com a nova funcionalidade de **Conversion Fee**, as cobranças relacionadas a operações crossborder passam a ser calculadas e registradas automaticamente, diretamente no fluxo transacional e no extrato (ledger). O objetivo é proporcionar mais transparência, previsibilidade e rastreabilidade para as taxas associadas a transações internacionais.

## **Visão geral**

A Conversion Fee automatiza a cobrança de custos de câmbio e impostos (como IOF) para operações crossborder, eliminando cálculos manuais e garantindo que cada transação tenha seus custos associados registrados de forma clara e vinculada.

| **Benefício**       | **Como ajuda**                                           |
| :------------------ | :------------------------------------------------------- |
| **Transparência**   | As cobranças ficam registradas diretamente no extrato    |
| **Previsibilidade** | Os custos são calculados automaticamente, sem surpresas  |
| **Rastreabilidade** | Cada fee fica vinculada à transação original             |
| **Conciliação**     | Extrato consistente, facilitando o fechamento financeiro |

## **Como funciona a Conversion Fee?**

A Conversion Fee é configurada como um percentual e aplicada sobre o **valor bruto da transação**.

### **Quando configurada:**

* A tarifa é calculada automaticamente
* O valor é registrado no extrato (ledger)
* A fee permanece vinculada à transação original

### **Fórmula de cálculo**

```text theme={null}
Conversion Fee = valor da transação × percentual da fee
```

Quando a Conversion Fee e o IOF estão configurados, os valores são somados e refletidos como uma única cobrança no extrato, sob a categoria **"conversion fee"**.

## **Quais transações geram Conversion Fee?**

A funcionalidade se aplica a operações crossborder elegíveis, incluindo:

| **Tipo de operação**        | **Descrição**                                               |
| :-------------------------- | :---------------------------------------------------------- |
| **Payin**                   | Recebimentos via PIX, cartão de crédito, boleto ou TED      |
| **Payout**                  | Pagamentos enviados via PIX ou TED                          |
| **Devoluções e reembolsos** | Transações de retorno, que também geram custos operacionais |

> 💡 Devoluções também entram, pois essas transações geram custos que devem ser considerados.

## **Como a Conversion Fee aparece no extrato?**

Com a nova funcionalidade, uma transação pode gerar até **três linhas** no extrato:

| **Linha**               | **Descrição**                          |
| :---------------------- | :------------------------------------- |
| **Transação principal** | Ex: PIX Payment, Cartão de Crédito     |
| **Fee operacional**     | Ex: taxa PIX, taxa cartão, taxa boleto |
| **Conversion Fee**      | Cobrança relacionada ao câmbio e IOF   |

Todas as linhas mantêm referência à transação original, garantindo rastreabilidade completa nos extratos e processos de conciliação.

<Frame>
  <img src="https://mintcdn.com/wepayments-cdc99ca4/TpIVXzkTATuNSWTA/images/image-(2)-1.png?fit=max&auto=format&n=TpIVXzkTATuNSWTA&q=85&s=e93b867a876a74733f14b291c8f36375" alt="Image (2) 1" width="1149" height="324" data-path="images/image-(2)-1.png" />
</Frame>

## **Impacto no saldo**

O comportamento da fee varia conforme o tipo de operação.

### **Payin (recebimento)**

| **Evento**                       | **Impacto**                               |
| :------------------------------- | :---------------------------------------- |
| Transação é creditada no extrato | A Conversion Fee é debitada imediatamente |
| Saldo disponível                 | Impacto direto no saldo disponível        |

### **Payout (pagamento)**

| **Evento**                       | **Impacto**                                                 |
| :------------------------------- | :---------------------------------------------------------- |
| Transação é criada               | O sistema verifica se há saldo suficiente para cobrir a fee |
| Pagamento processado com sucesso | A fee é descontada do saldo disponível                      |
| Pagamento rejeitado              | Nenhum valor é debitado – o saldo bloqueado é liberado      |

> ⚠️ **Importante:** É necessário ter saldo suficiente para cobrir a fee ao realizar um payout.

## **Exemplo prático**

### **Configuração**

* **Empresa:** Mercado Internacional Ltda (crossborder)
* **FX Fee:** 2,5%
* **IOF:** 0,38%
* **Transação:** Payout de R\$ 10.000,00 para fornecedor no Brasil

### **Cálculo**

| **Componente**           | **Cálculo**        | **Valor**      |
| :----------------------- | :----------------- | :------------- |
| FX Fee (2,5%)            | R\$ 10.000 × 2,5%  | R\$ 250,00     |
| IOF (0,38%)              | R\$ 10.000 × 0,38% | R\$ 38,00      |
| **Total Conversion Fee** | **Soma**           | **R\$ 288,00** |

### **Impacto no extrato**

| **Linha**                      | **Valor**           |
| :----------------------------- | :------------------ |
| Payout enviado ao beneficiário | - R\$ 10.000,00     |
| Conversion Fee (incluindo IOF) | - R\$ 288,00        |
| **Saldo disponível afetado**   | **- R\$ 10.288,00** |

## **Benefícios da automação**

| **Benefício**                | **Descrição**                                                                     |
| :--------------------------- | :-------------------------------------------------------------------------------- |
| **Cálculos automáticos**     | Ao calcular o valor em cada transação, reduzimos o tempo de espera do settlement. |
| **Transparência financeira** | Extrato com todas as cobranças visíveis e rastreáveis                             |
| **Vínculo com a transação**  | Cada fee fica associada à transação original                                      |
| **Conciliação simplificada** | Processo mais consistente e auditável                                             |
| **Maior previsibilidade**    | Custos conhecidos antecipadamente                                                 |
