# Tarifas Algunas operaciones pueden generar una tarifa. La API siempre informa el valor cobrado en **centavos**, y usted no necesita calcular nada: la plataforma aplica la tarifa configurada para su cuenta y devuelve el valor efectivamente cobrado en el estado de la transacción. ::: tip Dónde aparece la tarifa El campo `fee` en el estado de la transacción (`GET /transfers/:id` para TED y el estado del PIX) trae la tarifa cobrada por esa operación, en centavos. Cuando no hay tarifa, el valor es `0`. ::: ## Cómo se cobra la tarifa - **Unidad:** centavos, igual que todos los valores de la API. Una tarifa de R$ 5,00 llega como `500`. - **Momento:** la tarifa se cobra cuando la operación se concluye. En el PIX de salida se registra de forma asíncrona, justo después de la liquidación, por lo que el campo `fee` puede aparecer como `0` en una primera consulta y luego reflejar el valor cobrado en una consulta posterior. - **Fuente de verdad:** el `fee` del estado es la suma de lo que se registró efectivamente en el libro de tarifas para esa transacción. Es ese valor el que debe usar para conciliar. - **Límite:** la tarifa nunca consume la transacción entera. El valor cobrado es siempre menor que el monto de la operación. - **Débito:** la tarifa se debita de la cuenta que originó la operación, además del valor transferido. ## Consultando la tarifa de un PIX ```http GET /api/partner/v1/pix/{transactionId} Authorization: Bearer {{access_token}} ``` Respuesta `200`: ```json { "transactionId": "PIX20260711a1b2c3d4e5f6", "type": "pix_out", "status": "settled", "amount": 25000, "fee": 4, "recipientKey": "cliente@empresa.com.br", "endToEndId": "E4602656220260711100000abcdef123", "errorReason": null, "createdAt": "2026-07-11T10:00:00Z", "completedAt": "2026-07-11T10:00:02Z" } ``` En este ejemplo la operación de R$ 250,00 (`amount: 25000`) tuvo una tarifa de R$ 0,04 (`fee: 4`). El valor debitado de la cuenta fue la suma de ambos. ## Consultando la tarifa de una TED ```http GET /api/partner/v1/transfers/{transactionId} Authorization: Bearer {{access_token}} ``` El estado de la TED también expone el campo `fee` en centavos, completado cuando la TED liquida. ## Catálogo de tarifas Lista las tarifas activas aplicables a sus cuentas. La gestión de la tabla (valores y activación) la hace Monetarie; la API es de solo lectura. ```http GET /api/partner/v1/fees Authorization: Bearer {{access_token}} ``` - **Alcance:** `fee:read` Respuesta `200`: ```json { "data": [ { "feeType": "ted_out", "clientType": "pf", "subType": null, "fixedAmount": 500, "percent": "0", "minAmount": 100, "maxAmount": 900, "chargingModel": "immediate", "freeTransactionsPerMonth": 0, "effectiveFrom": "2026-07-14", "effectiveUntil": null, "scope": "global" } ] } ``` Los valores monetarios (`fixedAmount`, `minAmount`, `maxAmount`) están en **centavos**; `percent` es el componente porcentual de la tarifa. `scope` indica el alcance de la regla: `global` (todas las cuentas), `customer` (un cliente) o `account` (una cuenta específica). `effectiveFrom` y `effectiveUntil` delimitan la vigencia. ## Tarifas cobradas Lista las tarifas efectivamente cobradas a las cuentas del socio, con la correlación hacia la transacción que originó cada cobro. ```http GET /api/partner/v1/fees/charges?account_id=10024270&from=2026-07-01&to=2026-07-14&page=1&per_page=50 Authorization: Bearer {{access_token}} ``` - **Alcance:** `fee:read` · Filtros opcionales en la query string: `account_id`, `origin_transaction_id`, `from`, `to`, `page`, `per_page` (máximo 200). Respuesta `200`: ```json { "data": [ { "id": "5f6a7b8c-9d0e-4f1a-8b2c-3d4e5f6a7b8c", "feeType": "pix_out_transfer", "amount": 350, "originTransactionId": "E4602656220260714210000aabbccdd0", "originTransactionType": "pix", "originAmount": 10000, "status": "posted", "accountId": 10024270, "chargedAt": "2026-07-14T21:00:00Z" } ] } ``` `status` es `posted` cuando la tarifa está registrada y `reversed` cuando fue revertida. `originTransactionId`, `originTransactionType` y `originAmount` apuntan a la transacción principal y a su monto. ## Tarifa en el extracto La tarifa es siempre un movimiento separado de la transacción principal. En el extracto (`GET /accounts/{id}/statement`), los movimientos de tarifa tienen `type: "fee"` y llevan dos campos de correlación: `feeTransactionId`, el identificador del cobro (el mismo `id` del listado de tarifas cobradas), y `originTransactionId`, la transacción que originó la tarifa. ## Evento fee.charged Si prefiere ser notificado en vez de consultar, suscríbase al evento de webhook `fee.charged`, entregado cuando se cobra una tarifa: ```json { "feeTransactionId": "5f6a7b8c-9d0e-4f1a-8b2c-3d4e5f6a7b8c", "accountId": 10024270, "feeType": "ted_out", "amount": 500, "originTransactionId": "E4602656220260714210000aabbccdd0", "originTransactionType": "ted", "originalAmount": 150075, "status": "posted", "chargedAt": "2026-07-14T21:00:00Z" } ``` El formato de la entrega y la validación de firma están en [Webhooks](/es/endpoints/webhooks). ## Operaciones sin tarifa Algunos tipos de operación son gratuitos por exigencia regulatoria y siempre llegan con `fee: 0`, independientemente de la configuración de la cuenta: - PIX de persona física, en calidad de pagador o receptor, conforme a la Resolución BCB n.º 19/2020. - Devolución de PIX. - Servicios esenciales de cuenta de pago previstos en la regulación vigente. ## Cuándo hay tarifa Las operaciones que pueden generar tarifa incluyen, entre otras, PIX de salida de persona jurídica y TED. Los valores aplicados a su cuenta se definen en su contrato con Monetarie y pueden consultarse en el catálogo de tarifas de esta página. El resultado de cada cobro llega en el campo `fee`, en el listado de tarifas cobradas y en los movimientos `type: "fee"` del extracto. Si necesita condiciones distintas de las vigentes, hable con su contacto comercial. ## Boletos La emisión y la liquidación de boletos aún no están disponibles en la Partner API. Cuando se habiliten, seguirán el mismo modelo de esta página: la tarifa de la operación será informada en centavos en el campo `fee` del estado, sin que usted necesite calcular nada. La planificación de esta funcionalidad está en curso.