跳转到主要内容

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.

机构 API 包含机构专属接口，以及一套在标准商户路径中加入 institution 前缀的机构代理商户 API。签名算法及验签请参见 安全与签名。

​
请求头说明

Head 字段必填说明
X-GatePay-Certificate-ClientId是商户在 Gate 商户后台注册应用时分配的 clientId
X-GatePay-Timestamp是请求生成时的 UTC 时间戳，毫秒。GatePay 不处理收到请求时间与这个时间戳差距大于 10 秒钟的请求
X-GatePay-Nonce是随机字符串，建议长度在 32 个字符以内，字符串组成为数字和字母
X-GatePay-Signature是请求签名。GatePay 通过此签名来确定此请求是否合法
X-GatePay-On-Behalf-Of部分机构接口必填本次请求的发起方账户 ID。机构代理商户 API 通常填写目标子账户 ID；代扣、划转接口可填写机构账户 ID 或子账户 ID；子账户接口和费用设置接口不使用该请求头。

​
不需携带 X-GatePay-On-Behalf-Of 的接口

以下接口为机构主账号维度操作，请求头中不传 X-GatePay-On-Behalf-Of，仅使用前 4 个公共头即可： 账户
  • 创建子账户
  • 查询子账户
  • 分页查询子账户
代扣、划转以及机构代理商户 API 需要在请求头中携带 X-GatePay-On-Behalf-Of。其中，机构代理商户 API 通常填写目标子账户 ID；代扣、划转接口可填写本次交易的发起方账户 ID（机构账户或子账户）。子账户接口和费用设置接口不使用该请求头。