Stores
Get Gateway Fees
Learn how to query the configured payment gateway fees of a store using the endpoint GET /stores//fees.
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 (typeamongMERCADOPAGO,ASAAS,EFI_BANK, andSTRIPE, available methodsmethods[],maxInstallments,installmentFees[],feesper method withpercent+fixed, plus optional/nullablepublicKeywhen configured and optional/nullablepayeeCodeforEFI_BANKwhen configured).fees(top-level) β fees of the first active gateway, kept for compatibility with older consumers.- The
feesvalues (e.g. Mercado Pagocard4.99%, AsaaspixR$ 1.99 /card2.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.
β οΈ Possible errors
403 NO_ACTIVE_SUBSCRIPTIONβ the linked store has no active plan404 STORE_NOT_FOUNDβ store not found429 RATE_LIMIT_EXCEEDEDβ per-minute request limit exceeded500 INTERNAL_SERVER_ERRORβ internal error503 SERVICE_UNAVAILABLEβ service temporarily unavailable
π Notes
gateways[]reflects all gateways marked as active by the store owner (MERCADOPAGO,ASAAS,EFI_BANK,STRIPE).publicKeyis returned on the gateway object when present in the configured credentials (e.g. Mercado Pago or Stripe); forEFI_BANK,payeeCodeis also returned when configured.methods[]comes fromcredentials.paymentMethodsof each gateway (fallback: type default βMERCADOPAGO:pix/card/boleto/saldo;ASAAS,EFI_BANK, andSTRIPE:pix/card/boleto).maxInstallmentsβ maximum number of card installments configured by the merchant (default1, max12).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 theinstallmentCount, checkout and billing use it instead of the flatfees.cardfee β 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.