---
title: "Estimate Merchant Fees"
method: POST
path: "/payClearing/clearing/previewMerchantFee"
---

# Estimate Merchant Fees

`POST /payClearing/clearing/previewMerchantFee`

Estimates transaction fee, revenue share, and settlement amount based on merchant information and order parameters. Gate Pay merchants only.

## Headers

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

## Request body

- PreviewMerchantFeeRequest
  - `orderCurrency` string, required — Order currency, e.g., USDT, USDC, etc.
  - `accessMode` 0 | 1, required — Integration mode: 0=Gate Pay, 1=Web3 payment
  - `scenario` 0, required — Transaction type (Scenario): 0=Collection
  - `orderAmount` string, decimal, required — Order amount, must be greater than or equal to 0
  - `orderType` 0 | 1 | 2 | 3 | 4 — Order type. Optional values: 0-address payment, 1-checkout payment, 2-static QR code, 3-invoicing payment, 4-AI payment. If omitted, fallback rate applies.

## Response `200`

Estimation successful

- PreviewMerchantFeeResponse
  - `status` 'success' | 'error' — Response status: success/error
  - `code` string — Response code, 000000 indicates success
  - `errorMessage` string — Error message, empty on success
  - `data` PreviewMerchantFeeData
    - `merchantId` string — Merchant ID
    - `merchantType` 0 | 1 — Merchant type: 0=NORMAL_MERCHANT, 1=AGENT
    - `accessMode` 0 | 1 — Integration mode: 0=Gate Pay, 1=Web3 payment
    - `orderCurrency` string — Order currency
    - `orderAmount` number — Order amount
    - `orderFee` number — Transaction fee, collected by the platform
    - `institutionFeeAmount` number — Revenue share, the markup portion collected by the institution
    - `settleAmount` number — Settlement amount credited to the merchant balance after deducting transaction fee and revenue share

## Other responses

- `400` — Request parameter error
- `500` — Server error

---

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