---
title: "Retrieve fees"
method: GET
path: "/payment-intents/{id}/payment-fees"
tags: ["Payments"]
---

# Retrieve fees

`GET /payment-intents/{id}/payment-fees`

## Request

- The document declares no server URL.
- Auth: none declared. Required headers: `ApiKey`, `MerchantId`, `Environment`

This endpoint allows you to retrieve the fees associated with a payment intent.
    Fees are applied per payment and this endpoints will group all the fees in an array.

## Path parameters

- `id` string, required

## Query parameters

- `country` string, required
- `provider` string
- `paymentMethod` 'mobile_money' | 'credit_card' | 'bank_transfer' | 'instant_payment', required

## Headers

- `ApiKey` string, required
- `MerchantId` string, required
- `Environment` 'live' | 'sandbox', required

## Response `200`

- PaymentFeeDto[]
  - `id` string, required: Unique identifier of the applied Fee object.
  - `rate` number, required: A rate corresponding to the amount (flat or percentage) applied by the fees.
  - `rateType` 'percent' | 'flat', required: Fees can either be a flat amount of the transaction amount or percentage of the transaction amount.
  - `amount` number, required: Amount applied by this Fees. A positive integer representing how much to charge in the smallest currency unit (e.g., 100 cents to charge €1.00 or 100 to charge FCFA100, a zero-decimal currency).
  - `currency` string, required: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html).
  - `label` string: An optional label giving information on the reason of this fees.
  - `taxes` PaymentFeeTaxResponseDto[]: Taxes applied to this fee.
    - `id` string, required: Unique identifier of the applied tax.
    - `feeId` string, required: Identifier of the Fee this tax applies to.
    - `taxType` 'tva', required: Kind of tax applied.
    - `type` 'flat' | 'percent', required: How the tax amount was computed: a flat amount, or a percentage included in the fee amount.
    - `value` number, required: Tax amount, not rounded. For a `percent` tax it is the tax part of this fee, in the smallest currency unit, computed on a base that may differ from the one `amount` uses, so it may not match the tax contained in `amount`. For a `flat` tax it is the configured tax amount as is.

## Other responses

- `400`: Bad Request
- `401`: Wrong credentials
- `403`: Forbidden
- `404`: Not Found
- `429`: ThrottlerException: Too Many Requests
- `500`: Internal error

## Changes

- **2026-11-03** `f6d3f87df5e0`: 1 breaking, 8 info
  - the `items/taxes/items/` response's property type changed from `string` to `object` for status `200`
  - the `query` request parameter `provider` became optional
  - added the new enum value `instant_payment` to the `query` request parameter `paymentMethod`
  - added the non-success response with the status `400`
  - …5 more

[Operation history](https://skmtc.dev/hub2/apis/hub2-service-api/changes/payment-intents/:id/payment-fees/get.md)

---

[API](https://skmtc.dev/hub2/apis/hub2-service-api.md) - [All operations](https://skmtc.dev/hub2/apis/hub2-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hub2/apis/hub2-service-api/revisions/f6d3f87df5e0?raw)