Tiendas
Obtener Tasas del Gateway
Aprenda a consultar las tasas configuradas del gateway de pago de la tienda usando el endpoint GET /stores//fees.
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 (typeentreMERCADOPAGO,ASAAS,EFI_BANKySTRIPE, métodos disponiblesmethods[],maxInstallments,installmentFees[],feespor método conpercent+fixed, además depublicKeyopcional/nullable cuando esté configurada ypayeeCodeopcional/nullable paraEFI_BANKcuando esté configurado).fees(nivel superior) → tasas del primer gateway activo, mantenido para compatibilidad con consumidores antiguos.- Los valores de
fees(ej.: Mercado Pagocard4,99%, AsaaspixR$ 1,99 /card2,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.
⚠️ Posibles errores
403 NO_ACTIVE_SUBSCRIPTION→ la tienda vinculada no tiene un plan activo404 STORE_NOT_FOUND→ tienda no encontrada429 RATE_LIMIT_EXCEEDED→ límite de peticiones por minuto excedido500 INTERNAL_SERVER_ERROR→ error interno503 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).publicKeyse devuelve en el objeto de la gateway cuando está presente en las credenciales configuradas (ej.: Mercado Pago o Stripe); paraEFI_BANK, también se devuelvepayeeCodecuando está configurado.methods[]proviene decredentials.paymentMethodsde cada gateway (fallback: predeterminado del tipo —MERCADOPAGO:pix/card/boleto/saldo;ASAAS,EFI_BANKySTRIPE:pix/card/boleto).maxInstallments→ número máximo de cuotas en la tarjeta configurado por el lojista (predeterminado1, máximo12).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 delinstallmentCount, el checkout y el cobro lo usan en lugar de la tasa planafees.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.