> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cabrapi.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtener Tasas del Gateway

> Aprenda a consultar las tasas configuradas del gateway de pago de la tienda usando el endpoint GET /stores/{storeId}/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

| Parámetro | Tipo | Obligatorio | Descripción |
| - | - | - | - |
| `storeId` | string | Sí | ID de la tienda |

***

## ✅ Ejemplo de petición

```bash theme={null}
curl -X GET "https://api.cabrapi.com.br/v1/stores/STORE_ID/fees"
```

***

## 📦 Respuesta exitosa (200)

```json theme={null}
{
  "gateways": [
    {
      "type": "MERCADOPAGO",
      "publicKey": "APP_USR-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "methods": ["pix", "card", "boleto", "saldo"],
      "maxInstallments": 12,
      "installmentFees": [
        { "min": 1, "max": 1, "percent": 0, "fixed": 0 },
        { "min": 2, "max": 6, "percent": 3.49, "fixed": 0.49 },
        { "min": 7, "max": 12, "percent": 3.99, "fixed": 0.49 }
      ],
      "fees": {
        "pix": { "percent": 0, "fixed": 0 },
        "card": { "percent": 4.99, "fixed": 0 }
      }
    },
    {
      "type": "ASAAS",
      "methods": ["pix", "card", "boleto"],
      "maxInstallments": 1,
      "installmentFees": [],
      "fees": {
        "pix": { "percent": 0, "fixed": 1.99 },
        "card": { "percent": 2.99, "fixed": 0.49 }
      }
    },
    {
      "type": "STRIPE",
      "publicKey": "pk_live_xxxxxxxxxxxxxxxxxxxxxxxx",
      "methods": ["pix", "card", "boleto"],
      "maxInstallments": 1,
      "installmentFees": [],
      "fees": {
        "card": { "percent": 3.99, "fixed": 0.39 }
      }
    },
    {
      "type": "EFI_BANK",
      "payeeCode": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "methods": ["pix", "card", "boleto"],
      "maxInstallments": 1,
      "installmentFees": [],
      "fees": {
        "pix": { "percent": 0, "fixed": 0 }
      }
    }
  ],
  "fees": {
    "pix": { "percent": 0, "fixed": 0 },
    "card": { "percent": 4.99, "fixed": 0 }
  }
}
```

* `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:

```json theme={null}
{
  "gateways": [],
  "fees": {}
}
```

***

## ⚠️ 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.


## OpenAPI

````yaml GET /stores/{storeId}/fees
openapi: 3.1.0
info:
  title: caBRAPI
  version: 1.0.0
servers:
  - url: https://api.cabrapi.com.br/v1
security: []
paths:
  /stores/{storeId}/fees:
    get:
      tags:
        - Stores
      summary: Get store fees
      operationId: getStoreFees
      parameters:
        - $ref: '#/components/parameters/StoreId'
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  fees:
                    type: object
                  gateways:
                    items:
                      properties:
                        fees:
                          type: object
                        installmentFees:
                          items:
                            type: object
                          type: array
                        maxInstallments:
                          type: number
                        methods:
                          items:
                            type: string
                          type: array
                        type:
                          enum:
                            - MERCADOPAGO
                            - ASAAS
                            - EFI_BANK
                            - STRIPE
                          type: string
                        publicKey:
                          type: string
                        payeeCode:
                          type: string
                      required:
                        - type
                        - methods
                      type: object
                    type: array
                required:
                  - gateways
                  - fees
                type: object
          description: Active gateways and store fees.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: NO_ACTIVE_SUBSCRIPTION
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: STORE_NOT_FOUND
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Rate limit exceeded.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Internal server error.
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Service unavailable.
      security: []
components:
  parameters:
    StoreId:
      in: path
      name: storeId
      required: true
      schema:
        type: string
        minLength: 1
        maxLength: 50
  schemas:
    Error:
      properties:
        code:
          example: STORE_NOT_FOUND
          type: string
      required:
        - code
      type: object

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.