主动发起扣款
扣款
主动发起扣款
商户主动对订阅单发起扣款;subscriptionOrderNo 与 merchantSubscriptionOrderNo 须二选一传入。merchantDeductNo 在商户侧全局唯一,用于幂等。
POST
主动发起扣款
概述
本页说明POST /open/v1/order/deduct 接口。完整的请求参数、响应结构与示例由上方关联的 OpenAPI 定义渲染。
说明
- 鉴权使用 GatePay 标准签名请求头。
- 本页为商户开放平台路径说明。
- 签名与验签规则见 /api-reference/version/100/cn/common/securityAndSignature。
请求头
商户客户端ID,在 GatePay 平台申请获得
示例:
"4186d0c6-6a35-55a9-8dc6-5312769dbff8"
HMAC-SHA256签名,用于验证请求合法性
示例:
"672d5650dcc9bb22ebf25fa16c28d03c0e159d742a9176d4340a5da326d75dc8a2ec24c97fa6fc5d1533dd6e968863747e1d86a45e562cbe899f9ed7e9ca7f77"
时间戳(毫秒),与服务器时间差不能超过5分钟
示例:
"1672905655498"
随机数,用于防止重放攻击
示例:
"9578"
请求体
application/json
主动扣款请求体
商户扣款编号,全局唯一,用于幂等控制
扣款金额,须大于 0,且须与订阅单约定一致
扣款币种,须与订阅单一致
平台订阅订单编号(与 merchantSubscriptionOrderNo 二选一必填)
商户订阅订单编号(与 subscriptionOrderNo 二选一必填)
扣款说明,展示给用户,最多 100 字符
Maximum string length:
100
