curl --request POST \
--url https://openplatform.gateapi.io/pay-subscription/open/institution/v1/order/deduct \
--header 'Content-Type: application/json' \
--header 'X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>' \
--header 'X-GatePay-Nonce: <x-gatepay-nonce>' \
--header 'X-GatePay-Signature: <x-gatepay-signature>' \
--header 'X-GatePay-Timestamp: <x-gatepay-timestamp>' \
--data '
{
"merchantDeductNo": "DEDUCT_20260420_001",
"amount": 10.5,
"currency": "USDT"
}
'{
"code": "0",
"message": "",
"data": {
"deductOrderNo": "70778338049917033",
"merchantDeductNo": "DEDUCT_20260420_001",
"status": "SUCCESS",
"amount": "10.50000000",
"currency": "USDT",
"totalDeducted": "10.50000000",
"remainingAmount": "89.50000000",
"deductTime": 1773989575000
},
"success": true
}商户主动对订阅单发起扣款;subscriptionOrderNo 与 merchantSubscriptionOrderNo 须二选一传入。merchantDeductNo 在商户侧全局唯一,用于幂等。
curl --request POST \
--url https://openplatform.gateapi.io/pay-subscription/open/institution/v1/order/deduct \
--header 'Content-Type: application/json' \
--header 'X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>' \
--header 'X-GatePay-Nonce: <x-gatepay-nonce>' \
--header 'X-GatePay-Signature: <x-gatepay-signature>' \
--header 'X-GatePay-Timestamp: <x-gatepay-timestamp>' \
--data '
{
"merchantDeductNo": "DEDUCT_20260420_001",
"amount": 10.5,
"currency": "USDT"
}
'{
"code": "0",
"message": "",
"data": {
"deductOrderNo": "70778338049917033",
"merchantDeductNo": "DEDUCT_20260420_001",
"status": "SUCCESS",
"amount": "10.50000000",
"currency": "USDT",
"totalDeducted": "10.50000000",
"remainingAmount": "89.50000000",
"deductTime": 1773989575000
},
"success": true
}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.
POST /open/institution/v1/order/deduct 接口。完整的请求参数、响应结构与示例由上方关联的 OpenAPI 定义渲染。
商户客户端ID,在 GatePay 平台申请获得
"4186d0c6-6a35-55a9-8dc6-5312769dbff8"
HMAC-SHA256签名,用于验证请求合法性
"672d5650dcc9bb22ebf25fa16c28d03c0e159d742a9176d4340a5da326d75dc8a2ec24c97fa6fc5d1533dd6e968863747e1d86a45e562cbe899f9ed7e9ca7f77"
时间戳(毫秒),与服务器时间差不能超过5分钟
"1672905655498"
随机数,用于防止重放攻击
"9578"
主动扣款请求体
商户扣款编号,全局唯一,用于幂等控制
扣款金额,须大于 0,且须与订阅单约定一致
扣款币种,须与订阅单一致
平台订阅订单编号(与 merchantSubscriptionOrderNo 二选一必填)
商户订阅订单编号(与 subscriptionOrderNo 二选一必填)
扣款说明,展示给用户,最多 100 字符
100