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

# Taxas

> Como funcionam as taxas de plataforma e do merchant.

A Astron Pay usa um modelo de **taxa dupla**: a plataforma cobra uma taxa fixa por tipo de ordem, e o merchant pode adicionar sua própria taxa em cima.

## Componentes

* **Platform fee**: cobrada pela Astron Pay. Fixa por tier contratado.
* **Merchant fee**: cobrada pelo merchant ao receiver. Configurável via `PUT /fee-tiers/{orderType}` dentro dos limites permitidos.

## Como aparece nas cotações

A response pública de `POST /quote/payin` e `POST /quote/payout` **não** expõe os componentes de taxa separados — apenas duas taxas efetivas:

* `commercialRate` — taxa de câmbio comercial (sem spread).
* `ratePlatform` — taxa all-in (já inclui o spread da plataforma com todas as taxas embutidas).

A diferença entre `commercialRate` e `ratePlatform` é exatamente o spread total que a Astron Pay cobra. Internamente, esse spread se decompõe em:

* **Platform fee** — parcela da Astron Pay.
* **Merchant fee** — parcela do merchant.

O valor final que o receiver recebe (`amountToken` no payin, `netAmountBrl` no payout) já reflete `ratePlatform` aplicado sobre o valor de entrada.

## Fluxo de contabilização

1. Receiver paga R\$ 1.000 via PIX (payin).
2. Taxa da plataforma (R\$ 5) vai para `PLATFORM_FEE`.
3. Taxa do merchant (R\$ 10) vai para `MERCHANT_FEE` do merchant.
4. Os R\$ 985 restantes são convertidos e entregues em USDC na wallet destino.
5. Na liquidação (`Settlement`), o saldo de `MERCHANT_FEE` é enviado ao merchant via PIX.

## Ajustando a taxa do merchant

```bash theme={null}
curl -X PUT https://api.astronpay.co/api/v1/fee-tiers/PAYIN \
  -H "x-api-key: $API_KEY" \
  -H "x-api-secret: $API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{ "merchantFeePercentage": 2.0 }'
```

Os novos percentuais valem para cotações geradas após a atualização.

## Limites

A Astron Pay define um percentual máximo de `merchantFeePercentage` por tier. Tentativas de configurar além do máximo retornam `400 VALIDATION_ERROR`.