Lojas
Obter Taxas do Gateway
Aprenda a consultar as taxas configuradas do gateway de pagamento da loja usando o endpoint GET /stores//fees.
GET
Get store fees
💰 Obter Taxas do Gateway
GET /stores/{storeId}/fees
Retorna as formas de pagamento e as taxas das gateways ativas da loja.
Importante: as taxas retornadas aqui são as definidas pelo lojista no dashboard (seção “Taxas por método” de cada gateway), ou seja, o percentual/valor fixo que ele decide repassar ao cliente no checkout. Elas não representam o custo que a gateway cobra do lojista — esse custo é interno e fica apenas no frontend do dashboard (tabela GATEWAY_FEES), usado para calcular o valor líquido que o lojista recebe.
🔐 Autenticação
- Rota pública.
- A loja vinculada precisa ter plano ativo.
🧾 Parâmetros de rota
✅ Exemplo de requisição
📦 Resposta de sucesso (200)
gateways[]→ todas as gateways ativas do dono da loja (typeentreMERCADOPAGO,ASAAS,EFI_BANKeSTRIPE, métodos disponíveismethods[],maxInstallments,installmentFees[],feespor método compercent+fixed, além depublicKeyopcional/nullable quando configurada epayeeCodeopcional/nullable paraEFI_BANKquando configurado).fees(top-level) → taxas do primeiro gateway ativo, mantido para compatibilidade com consumidores antigos.- Os valores de
fees(ex.: Mercado Pagocard4,99%, AsaaspixR$ 1,99 /card2,99% + R$ 0,49) são configurados pelo lojista e podem variar de loja para loja — não são valores fixos garantidos nem o custo real da gateway.
⚠️ Possíveis erros
403 NO_ACTIVE_SUBSCRIPTION→ a loja vinculada está sem plano ativo404 STORE_NOT_FOUND→ loja não encontrada429 RATE_LIMIT_EXCEEDED→ limite de requisições por minuto excedido500 INTERNAL_SERVER_ERROR→ erro interno503 SERVICE_UNAVAILABLE→ serviço temporariamente indisponível
📝 Observações
gateways[]reflete todas as gateways marcadas como ativas do dono da loja (MERCADOPAGO,ASAAS,EFI_BANK,STRIPE).publicKeyé retornado no objeto da gateway quando presente nas credenciais configuradas (ex.: Mercado Pago ou Stripe); paraEFI_BANK,payeeCodetambém é retornado quando configurado.methods[]vem decredentials.paymentMethodsde cada gateway (fallback: padrão do tipo —MERCADOPAGO:pix/card/boleto/saldo;ASAAS,EFI_BANKeSTRIPE:pix/card/boleto).maxInstallments→ número máximo de parcelas no cartão configurado pelo lojista (padrão1, máximo12).installmentFees→ lista de faixas de parcelas configuradas pelo lojista, com taxa própria por intervalo{ min, max, percent, fixed }(máximo 12 faixas, sem sobreposição). Quando a faixa doinstallmentCountexiste, checkout e cobrança a usam no lugar da taxa planafees.card— garantindo que o valor exibido ao cliente bate com o cobrado.- Taxas são lidas das credenciais descriptografadas (AES-256-GCM) do gateway.
- O checkout público usa esta rota para exibir as formas de pagamento reais da loja (ex.: Mercado Pago + Asaas), as parcelas disponíveis (
maxInstallments) e calcular o repasse de taxa por método/faixa.