Saltar al contenido principal
GET
Get store fees

💰 Obtener Tasas del Gateway

GET /stores/{storeId}/fees Devuelve las formas de pago y las tasas de los gateways activos de la tienda.
Importante: las tasas devueltas aquí son las definidas por el lojista en el dashboard (sección “Tasas por método” de cada gateway), es decir, el porcentaje/valor fijo que él decide repercutir al cliente en el checkout. No representan el costo que la gateway cobra al lojista — ese costo es interno y queda solo en el frontend del dashboard (tabla GATEWAY_FEES), usado para calcular el valor líquido que el lojista recibe.

🔐 Autenticación

  • Ruta pública.
  • La tienda vinculada debe tener un plan activo.

🧾 Parámetros de ruta


✅ Ejemplo de petición


📦 Respuesta exitosa (200)

  • gateways[] → todas las gateways activas del propietario de la tienda (type entre MERCADOPAGO, ASAAS, EFI_BANK y STRIPE, métodos disponibles methods[], maxInstallments, installmentFees[], fees por método con percent + fixed, además de publicKey opcional/nullable cuando esté configurada y payeeCode opcional/nullable para EFI_BANK cuando esté configurado).
  • fees (nivel superior) → tasas del primer gateway activo, mantenido para compatibilidad con consumidores antiguos.
  • Los valores de fees (ej.: Mercado Pago card 4,99%, Asaas pix R$ 1,99 / card 2,99% + R$ 0,49) son configurados por el lojista y pueden variar de tienda a tienda — no son valores fijos garantizados ni el costo real de la gateway.
Cuando la tienda no tiene un gateway activo (o no tiene credenciales configuradas), las tasas se devuelven vacías:

⚠️ Posibles errores

  • 403 NO_ACTIVE_SUBSCRIPTION → la tienda vinculada no tiene un plan activo
  • 404 STORE_NOT_FOUND → tienda no encontrada
  • 429 RATE_LIMIT_EXCEEDED → límite de peticiones por minuto excedido
  • 500 INTERNAL_SERVER_ERROR → error interno
  • 503 SERVICE_UNAVAILABLE → servicio temporalmente no disponible

📝 Observaciones

  • gateways[] refleja todas las gateways marcadas como activas del propietario de la tienda (MERCADOPAGO, ASAAS, EFI_BANK, STRIPE).
  • publicKey se devuelve en el objeto de la gateway cuando está presente en las credenciales configuradas (ej.: Mercado Pago o Stripe); para EFI_BANK, también se devuelve payeeCode cuando está configurado.
  • methods[] proviene de credentials.paymentMethods de cada gateway (fallback: predeterminado del tipo — MERCADOPAGO: pix/card/boleto/saldo; ASAAS, EFI_BANK y STRIPE: pix/card/boleto).
  • maxInstallments → número máximo de cuotas en la tarjeta configurado por el lojista (predeterminado 1, máximo 12).
  • installmentFees → lista de rangos de cuotas configurados por el lojista, con tasa propia por intervalo { min, max, percent, fixed } (máximo 12 rangos, sin solapamiento). Cuando existe el rango del installmentCount, el checkout y el cobro lo usan en lugar de la tasa plana fees.card — garantizando que el valor mostrado al cliente coincida con el cobrado.
  • Las tasas se leen de las credenciales desencriptadas (AES-256-GCM) del gateway.
  • El checkout público usa esta ruta para mostrar las formas de pago reales de la tienda (ej.: Mercado Pago + Asaas), las cuotas disponibles (maxInstallments) y calcular la repercusión de tasa por método/rango.

Parámetros de ruta

storeId
string
requerido
Required string length: 1 - 50

Respuesta

Active gateways and store fees.

fees
object
requerido
gateways
object[]
requerido