Tarifas da conta
GET /accounts/:id/fees — tarifas Pix in/out (fixa + bps).
Tarifas da conta
Tarifas Pix in/out aplicadas à conta. Cada tarifa tem um componente fixo (*FeeCents) e um percentual em basis points (*FeeBps; 100 = 1%).
GET/accounts/:accountId/fees
A tarifa efetiva de uma transação é: *FeeCents + (amountCents × *FeeBps / 10000). Ex.: pixOutFeeCents=50 e pixOutFeeBps=10 em transação de R$ 100,00 (10000 centavos) → 50 + (10000 × 10 / 10000) = 60 centavos.
Path params
- accountIdObrigatóriostring (UUID)ID da conta.
Headers
- AcceptObrigatóriostringapplication/json
- AuthorizationObrigatóriostringBearer <token> — JWT de /authenticate.
- X-Tenant-IdObrigatóriostring (UUID)Identificador do tenant.
Exemplo de requisição
bash
curl https://baas.staterpay.io/accounts/00000000-0000-0000-0000-000000000010/fees \ -H "Accept: application/json" \ -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.<payload>.<signature>" \ -H "X-Tenant-Id: 00000000-0000-0000-0000-000000000000"Resposta
- pixInFeeCentsstringTarifa fixa em centavos para Pix recebido.
- pixInFeeBpsnumberPercentual em basis points para Pix recebido (100 bps = 1%).
- pixOutFeeCentsstringTarifa fixa em centavos para Pix enviado.
- pixOutFeeBpsnumberPercentual em basis points para Pix enviado.
- updatedAtstring (ISO-8601 UTC-3)Última atualização da configuração de tarifas.
json
{ "pixInFeeCents": "0", "pixInFeeBps": 0, "pixOutFeeCents": "0", "pixOutFeeBps": 0, "updatedAt": "2026-05-10T07:28:18.720-03:00"}URL base:
https://baas.staterpay.io