> ## 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. [快速开始](/essentials/version/100/cn/common/quickstart)
2. [商户接入](/essentials/version/100/cn/common/accessguide)
3. [认证](/essentials/version/100/cn/common/authentication)
4. [通知](/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 请求，详见 [认证与安全](/essentials/version/100/cn/common/authentication)。 |
| Payment API Secret   | 支付相关 API 请求签名和验签使用的服务端签名密钥。                                                                                               |
| Authorization Secret | 授权 API 请求签名和验签使用的服务端签名密钥（仅用于授权 API）。                                                                                      |
| 回调 URL               | 配置用于接收异步支付通知的接口。                                                                                                          |

**重要：** 任何使用异步通知的 API 都需要配置有效的回调 URL，否则通知无法送达。有关如何验证传入回调的详情，请参见 [认证与安全](/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`         | 机构代理请求头。除创建子账户、查询子账户详情、分页查询子账户外，其余机构接口均需携带。 |

有关请求头、签名和验签的详细说明，请参见 [认证与安全](/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

## 后续步骤

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