Common
Balance
Institution
Payment
OTC
Convert
Payout
Gift Card
Subscription
curl --request POST \
--url https://openplatform.gateapi.io/rate/commission_rule/upgrade \
--header 'Content-Type: application/json' \
--header 'X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>' \
--header 'X-GatePay-MerchantId: <x-gatepay-merchantid>' \
--header 'X-GatePay-Nonce: <x-gatepay-nonce>' \
--header 'X-GatePay-Signature: <x-gatepay-signature>' \
--header 'X-GatePay-Timestamp: <x-gatepay-timestamp>' \
--data '
{
"r_markup": 0.002,
"effective_date": "2026-05-01 00:00:00"
}
'{
"status": "SUCCESS",
"code": "000000",
"errorMessage": "",
"data": {
"config_id": "cfg_202605010001",
"previous_config_id": "cfg_existing_xxx",
"version_no": 2,
"sub_merchant_id": "123456789",
"r_markup": 0.002,
"f_markup": 1,
"status": "PENDING_EFFECTIVE",
"effective_date": "2026-05-01 00:00:00",
"due_date": null,
"created_at": "2026-04-17T09:00:00Z",
"updated_at": "2026-04-17T09:00:00Z"
}
}Update Fee Rule
Creates a new rule version. A successful request does not immediately replace the current effective rule, but any pending-effective version is invalidated. When the new version becomes effective, it fully replaces the current rule.
curl --request POST \
--url https://openplatform.gateapi.io/rate/commission_rule/upgrade \
--header 'Content-Type: application/json' \
--header 'X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>' \
--header 'X-GatePay-MerchantId: <x-gatepay-merchantid>' \
--header 'X-GatePay-Nonce: <x-gatepay-nonce>' \
--header 'X-GatePay-Signature: <x-gatepay-signature>' \
--header 'X-GatePay-Timestamp: <x-gatepay-timestamp>' \
--data '
{
"r_markup": 0.002,
"effective_date": "2026-05-01 00:00:00"
}
'{
"status": "SUCCESS",
"code": "000000",
"errorMessage": "",
"data": {
"config_id": "cfg_202605010001",
"previous_config_id": "cfg_existing_xxx",
"version_no": 2,
"sub_merchant_id": "123456789",
"r_markup": 0.002,
"f_markup": 1,
"status": "PENDING_EFFECTIVE",
"effective_date": "2026-05-01 00:00:00",
"due_date": null,
"created_at": "2026-04-17T09:00:00Z",
"updated_at": "2026-04-17T09:00:00Z"
}
}Documentation Index
Fetch the complete documentation index at: https://docs.gate.com/llms.txt
Use this file to discover all available pages before exploring further.
Overview
This page documents the institution-only API that updates a sub-account fee rule by creating a new version. Full fields, request payloads, and examples are rendered from the OpenAPI definition above.Notes
- This endpoint creates a new rule version. A successful request does not immediately replace the currently effective rule, but any pending-effective version is invalidated. When the new version becomes effective, it fully replaces the current rule.
- It uses
X-GatePay-MerchantIdto identify the main-merchant context and does not useX-GatePay-On-Behalf-Of. - The request body uses
sub_merchant_idto identify which sub-account rule to update;config_idis no longer used as the update input.
Headers
Application ClientId.
HMAC-SHA512 signature generated with the Payment API Secret.
UTC timestamp in milliseconds.
Random nonce used for replay protection.
Main merchant ID. This header identifies the institution main-merchant context for this fee-setting API set.
Body
Sub-account ID.
"123456789"
New percentage markup. Must not be null; 0 is allowed.
0.002
New version effective time in yyyy-MM-dd HH:mm:ss format; precision must include seconds.
"2026-05-01 00:00:00"
New fixed markup amount in USDT. Defaults to 0.
1
New version expiration time in the same format as effective_date; omit for no expiration.
null