Skip to main content
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

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.