Skip to main content
GET
Get store fees

πŸ’° Get Gateway Fees

GET /stores/{storeId}/fees Returns the payment methods and fees of the store’s active gateways.
Important: the fees returned here are the ones defined by the merchant in the dashboard (section β€œFees by method” of each gateway), i.e. the percentage/fixed amount they decide to pass on to the customer at checkout. They do not represent the cost charged by the gateway to the merchant β€” that cost is internal and stays only in the dashboard frontend (table GATEWAY_FEES), used to calculate the net amount the merchant receives.

πŸ” Authentication

  • Public route.
  • The linked store must have an active plan.

🧾 Route parameters


βœ… Example request


πŸ“¦ Success response (200)

  • gateways[] β†’ all active gateways of the store owner (type among MERCADOPAGO, ASAAS, EFI_BANK, and STRIPE, available methods methods[], maxInstallments, installmentFees[], fees per method with percent + fixed, plus optional/nullable publicKey when configured and optional/nullable payeeCode for EFI_BANK when configured).
  • fees (top-level) β†’ fees of the first active gateway, kept for compatibility with older consumers.
  • The fees values (e.g. Mercado Pago card 4.99%, Asaas pix R$ 1.99 / card 2.99% + R$ 0.49) are configured by the merchant and may vary from store to store β€” they are not guaranteed fixed values nor the real cost of the gateway.
When the store has no active gateway (or no configured credentials), fees return empty:

⚠️ Possible errors

  • 403 NO_ACTIVE_SUBSCRIPTION β†’ the linked store has no active plan
  • 404 STORE_NOT_FOUND β†’ store not found
  • 429 RATE_LIMIT_EXCEEDED β†’ per-minute request limit exceeded
  • 500 INTERNAL_SERVER_ERROR β†’ internal error
  • 503 SERVICE_UNAVAILABLE β†’ service temporarily unavailable

πŸ“ Notes

  • gateways[] reflects all gateways marked as active by the store owner (MERCADOPAGO, ASAAS, EFI_BANK, STRIPE).
  • publicKey is returned on the gateway object when present in the configured credentials (e.g. Mercado Pago or Stripe); for EFI_BANK, payeeCode is also returned when configured.
  • methods[] comes from credentials.paymentMethods of each gateway (fallback: type default β€” MERCADOPAGO: pix/card/boleto/saldo; ASAAS, EFI_BANK, and STRIPE: pix/card/boleto).
  • maxInstallments β†’ maximum number of card installments configured by the merchant (default 1, max 12).
  • installmentFees β†’ list of installment ranges configured by the merchant, with its own fee per interval { min, max, percent, fixed } (max 12 ranges, no overlap). When a range exists for the installmentCount, checkout and billing use it instead of the flat fees.card fee β€” ensuring the amount shown to the customer matches what is charged.
  • Fees are read from the decrypted credentials (AES-256-GCM) of the gateway.
  • The public checkout uses this route to display the store’s real payment methods (e.g. Mercado Pago + Asaas), available installments (maxInstallments) and to calculate the fee pass-through per method/range.

Path Parameters

storeId
string
required
Required string length: 1 - 50

Response

Active gateways and store fees.

fees
object
required
gateways
object[]
required