> ## 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.

# 总览

> 本文档介绍 GatePay 外部 API 的接入前置条件、基础配置、服务地址、应用创建、密钥管理，以及支持的支付网络和币种。

## 推荐阅读顺序

如果你是第一次接入，建议按以下顺序阅读：

1. [快速开始](/global/essentials/version/100/cn/common/quickstart)
2. [商户接入](/global/essentials/version/100/cn/common/accessguide)
3. [认证](/global/essentials/version/100/cn/common/authentication)
4. [通知](/global/essentials/version/100/cn/common/notification)
5. 对应产品线的 Guide 与 API Reference

## 商户入驻与应用配置

### 基础地址

| 项目 | 值 |
| - | - |
| 服务基础 URL | `https://openplatform.gateapi.io` |

本文档中的所有 API 路径都需要与基础地址拼接后，形成完整请求 URL。

### 创建并配置应用

请按以下步骤在 GatePay 商户门户中完成应用配置：

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

### 配置凭证

完成应用配置后，你将获得以下凭证:

| 凭证 | 说明 |
| - | - |
| `ClientId` | 你的应用唯一标识。通过 `X-GatePay-Certificate-ClientId` 请求头用于所有 API 请求，详见 [认证与安全](/global/essentials/version/100/cn/common/authentication)。 |
| Payment API Secret | 支付相关 API 请求签名和验签使用的服务端签名密钥。 |
| Authorization Secret | 授权 API 请求签名和验签使用的服务端签名密钥（仅用于授权 API）。 |
| 回调 URL | 配置用于接收异步支付通知的接口。 |

**重要：** 任何使用异步通知的 API 都需要配置有效的回调 URL，否则通知无法送达。有关如何验证传入回调的详情，请参见 [认证与安全](/global/essentials/version/100/cn/common/authentication)。

### 通用请求头

除机构专属接口外，常规 API 请求通常会使用以下通用请求头：

| 请求头 | 说明 |
| - | - |
| `X-GatePay-Certificate-ClientId` | 应用身份标识 |
| `X-GatePay-Timestamp` | UTC 毫秒时间戳 |
| `X-GatePay-Nonce` | 随机字符串 |
| `X-GatePay-Signature` | 按签名规则生成的请求签名 |
| `X-GatePay-On-Behalf-Of` | 机构代理请求头。除创建子账户、查询子账户详情、分页查询子账户外，其余机构接口均需携带。 |

有关请求头、签名和验签的详细说明，请参见 [认证与安全](/global/essentials/version/100/cn/common/authentication)。

### SDK 支持

最新官方 SDK 与客户端仓库统一维护在 Gate GitHub 组织：

[https://github.com/gate](https://github.com/gate)

当前公开可见的多语言 SDK / 客户端资源包括：

| 仓库 | 语言 | 说明 |
| - | - | - |
| `gatepay-sdk-java` | Java | GatePay Java 语言仓库，[仓库地址](https://github.com/gate/gatepay-sdk-java) |
| `gatepay-sdk-go` | Go | GatePay Go 语言仓库，[仓库地址](https://github.com/gate/gatepay-sdk-go) |
| `gatepay-sdk-python` | Python | GatePay Python SDK 仓库，[仓库地址](https://github.com/gate/gatepay-sdk-python) |
| `gatepay-sdk-android` | Android | GatePay Android SDK 仓库，[仓库地址](https://github.com/gate/gatepay-sdk-android) |
| `gatepay-sdk-ios` | iOS | GatePay iOS SDK 仓库，[仓库地址](https://github.com/gate/gatepay-sdk-ios) |
| `gatepay-call-payment-sdk-android` | Android Call Payment | GatePay Android Call Payment SDK 仓库，[仓库地址](https://github.com/gate/gatepay-call-payment-sdk-android) |
| `gatepay-call-payment-sdk-iOS` | iOS Call Payment | GatePay iOS Call Payment SDK 仓库，[仓库地址](https://github.com/gate/gatepay-call-payment-sdk-iOS) |

建议以 Gate GitHub 组织页展示的最新仓库列表为准；如果某个接口场景暂未提供现成 SDK，也可以直接按本文档中的 REST API 接口接入。

## 支持的支付网络和币种

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

基于地址的支付支持以下网络和代币:

| 区块链网络 | 支持币种 |
| - | - |
| Ethereum / ERC20 | ETH, POL, USDC, USDT,USDS |
| Polygon | POL, USDC, USDT |
| Arbitrum One / ERC20 | USDC, USDT |
| BNB Smart 链 / BEP20 | BNB、USDT |
| Solana | SOL, USDC, USDT |
| Tron / TRC20 | TRX、USDT |
| Base | USDC |
| Ton | USDT |
| Bitcoin BRC20 / Ordinals | BTC |

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

其他支付方式支持以下加密货币和数字资产:

BTC, USDT, USD, GT, ETH, EOS, DOGE, DOT, SHIB, LTC, ADA, BCH, FIL, ZEC, BNB, UNI, XRP, STEPG, SUPE, LION, FROG

## 后续步骤

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.