---
title: "Retrieve detailed fee information for an order"
method: GET
path: "/api/open/v1/pay/order/fee/query"
---

# Retrieve detailed fee information for an order

`GET /api/open/v1/pay/order/fee/query`

Query transaction fee, revenue share, payment details, and settlement information by merchant trade number. This is a GET endpoint; pass `merchantTradeNo` as a URL query parameter.

## Query parameters

- `merchantTradeNo` string, required

## Headers

- `X-GatePay-Certificate-ClientId` string, required
- `X-GatePay-Signature` string, required
- `X-GatePay-Timestamp` string, required
- `X-GatePay-Nonce` string, required

## Response `200`

Success

- FeeQueryResponse
  - `status` 'SUCCESS' | 'FAIL' — SUCCESS or FAIL
  - `code` string — Error code
  - `errorMessage` string — Error message
  - `data` FeeQueryData
    - `merchantTradeNo` string — Merchant order ID
    - `orderCurrency` string — Order currency
    - `orderAmount` string — Order amount
    - `payAmount` string — Total amount paid
    - `totalFeeAmount` string — Total transaction fee collected by the platform. May be empty or 0 if payment records are unsettled, unpaid, or centralized-only
    - `totalInstitutionFeeAmount` string — Total revenue share collected for the order. May be empty or 0 if payment records are unsettled, unpaid, or centralized-only
    - `totalSettleAmount` string — Total settlement amount credited to the merchant balance after deducting fees and revenue share. May be empty if unsettled
    - `payDetails` PayDetail[] — Payment breakdown per transaction
      - `transactionId` string — Payment ID
      - `payType` string — Payment type
      - `payTime` string — Payment time
      - `payAmount` string — Payment amount
      - `payCurrency` string — Payment currency
      - `feeAmount` string — Transaction fee, collected by the platform
      - `settleAmount` string — Settlement amount credited to the merchant balance after deducting transaction fee and revenue share
      - `institutionFeeAmount` string — Revenue share, the markup portion collected by the institution

---

[API](https://skmtc.dev/gate/apis/gatepay-common-api.md) · [All operations](https://skmtc.dev/gate/apis/gatepay-common-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gate/gatepay-common-api/revisions/3dd1d8e41817/schema)