支付渠道 API（Payment Gateway API）
支付渠道 API、支付通道 API 与 Payment Gateway API 在商户语境下通常指：通过 HTTPS 调用支付平台，完成收款（Payin）、付款（Payout）、查询与通知的一套接口。SoPay 文档中心即面向此类 Payment Channel API 集成，提供 代收代付 API、跨境支付 API 多国说明与统一 Signature、Callback 规范。
支付渠道 API 是什么
对商户而言，支付渠道 API 是「业务系统 ↔ 支付平台」的边界：
- 入金：用户向商户付款（代收 / Payin）
- 出金：商户向用户或供应商付款（代付 / Payout）
- 状态同步：查询 + 异步 Webhook
- 安全：RSA2 等签名机制，防止伪造请求
底层可能对接多家银行、钱包或本地清算网络；商户通常只对接 一层平台 API，这就是 三方支付 API 或 四方支付 API 架构中「平台对商户」的那一层接口。
三方支付 API 与四方支付 API（常见区别）
行业口语中：
| 说法 | 常见含义（简化） |
|---|---|
| 三方支付 API | 持牌或聚合机构作为「第三方」，连接商户与银行/通道；商户对接该机构的 Payment Gateway API |
| 四方支付 API | 在三方之上再有一层技术或商务聚合，商户可能对接 四方 提供的统一 支付通道 API；底层仍依赖合规通道 |
SoPay 文档站从 商户集成 角度描述 API，不对牌照形态做法律定性。您只需按合同对接 SoPay 提供的 商户 API 与 签名规范，具体合规与通道关系以商务与法务说明为准。
代收、代付、回调、签名、商户钱包
SoPay 文档中的 Payment API 核心模块包括：
| 模块 | 作用 | 文档 |
|---|---|---|
| Payin / 代收 | 创建收款订单 | 各国 */payin 页，如 印度代收 |
| Payout / 代付 | 创建出款订单 | 代付 API 专题、泰国代付 |
| Callback / 回调 | 终态异步通知 | 异步回调指南 |
| Signature / 签名 | 请求与通知验签 | 签名规范 |
| Wallet / 钱包 | 余额与流水（部分国家） | 如 印度总览 |
跨境支付 API 在文档中体现为：按国家/币种划分的 API 总览（countryCode + currency），例如 INR、THB、PKR、CNY 等，而非单一全球接口。
多国家支付接入
SoPay 文档按国家/地区组织 支付 API 说明：
| 地区 | SEO / 专题页 | API 总览 |
|---|---|---|
| 印度 | 印度支付 API | 印度总览 |
| 泰国 | 泰国支付 API | 泰国总览 |
| 巴基斯坦 | 巴基斯坦支付 API | 巴基斯坦总览 |
| 中国 | — | 中国总览 |
如何选择阅读路径
常见问题（FAQ）
SoPay 文档是 Open API 还是 REST Header 签名？
不同国家/历史版本文档可能并存。以您商户包与该国 overview 为准，不要混用鉴权方式。
是否提供统一全球 Payment API？
文档按 国家 + 币种 拆分。跨境业务需在各国别下分别对接并遵守当地字段要求。
回调必须返回什么？
验签成功后返回 HTTP 200，正文 OK，详见 回调指南。
哪里看错误码？
各国附录或 印度错误码 等页面；亦可能由运营单独提供码表。