跳转到主要内容

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.

​
推荐阅读顺序

如果你是第一次接入，建议按以下顺序阅读：
  1. 快速开始
  2. 商户接入
  3. 认证
  4. 通知
  5. 对应产品线的 Guide 与 API Reference

​
商户入驻与应用配置

​
基础地址

项目值
服务基础 URLhttps://openplatform.gateapi.io
本文档中的所有 API 路径都需要与基础地址拼接后，形成完整请求 URL。

​
创建并配置应用

请按以下步骤在 GatePay 商户门户中完成应用配置：
步骤操作
1登录 GatePay 商户门户，完成商户注册和初始化配置。
2填写所需的业务信息并提交商户申请。
3进入应用配置页面，创建或配置新的应用。
4从应用列表获取你的 ClientId。
5按需配置回调地址，用于接收异步通知。

​
配置凭证

完成应用配置后，你将获得以下凭证:
凭证说明
ClientId你的应用唯一标识。通过 X-GatePay-Certificate-ClientId 请求头用于所有 API 请求，详见 认证与安全。
Payment API Secret支付相关 API 请求签名和验签使用的服务端签名密钥。
Authorization Secret授权 API 请求签名和验签使用的服务端签名密钥（仅用于授权 API）。
回调 URL配置用于接收异步支付通知的接口。
重要： 任何使用异步通知的 API 都需要配置有效的回调 URL，否则通知无法送达。有关如何验证传入回调的详情，请参见 认证与安全。

​
通用请求头

除机构专属接口外，常规 API 请求通常会使用以下通用请求头：
请求头说明
X-GatePay-Certificate-ClientId应用身份标识
X-GatePay-TimestampUTC 毫秒时间戳
X-GatePay-Nonce随机字符串
X-GatePay-Signature按签名规则生成的请求签名
X-GatePay-On-Behalf-Of机构代理请求头。除创建子账户、查询子账户详情、分页查询子账户外，其余机构接口均需携带。
有关请求头、签名和验签的详细说明，请参见 认证与安全。

​
SDK 支持

最新官方 SDK 与客户端仓库统一维护在 Gate GitHub 组织： https://github.com/gate 当前公开可见的多语言 SDK / 客户端资源包括：
仓库语言说明
gatepay-sdk-javaJavaGatePay Java 语言仓库，仓库地址
gatepay-sdk-goGoGatePay Go 语言仓库，仓库地址
gatepay-sdk-pythonPythonGatePay Python SDK 仓库，仓库地址
gatepay-sdk-androidAndroidGatePay Android SDK 仓库，仓库地址
gatepay-sdk-iosiOSGatePay iOS SDK 仓库，仓库地址
gatepay-call-payment-sdk-androidAndroid Call PaymentGatePay Android Call Payment SDK 仓库，仓库地址
gatepay-call-payment-sdk-iOSiOS Call PaymentGatePay iOS Call Payment SDK 仓库，仓库地址
建议以 Gate GitHub 组织页展示的最新仓库列表为准；如果某个接口场景暂未提供现成 SDK，也可以直接按本文档中的 REST API 接口接入。

​
支持的支付网络和币种

​
区块链网络及支持的加密货币

基于地址的支付支持以下网络和代币:
区块链网络支持币种
Ethereum / ERC20DAI, ETH, POL, USDC, USDT
PolygonDAI, POL, USDC, USDT
Arbitrum One / ERC20USDC, USDT
BNB Smart 链 / BEP20BNB、USDT
SolanaSOL, USDC, USDT
Tron / TRC20TRX、USDT
BaseUSDC
Bitcoin BRC20 / OrdinalsBTC

​
其他支付渠道支持的币种

其他支付方式支持以下加密货币和数字资产: BTC, USDT, USD, GT, ETH, EOS, DOGE, DOT, SHIB, LTC, ADA, BCH, FIL, ZEC, BNB, UNI, XRP, STEPG, SUPE, LION, FROG

​
后续步骤

  • 如果你想先跑通第一条链路，请先查看 快速开始
  • 有关认证详情和请求签名，请参见 认证与安全
  • 有关支付 API 接入，请参阅对应支付流程文档
  • 有关错误处理和最佳实践，请参阅错误码与故障排查指南