代付 API（Payout API）
代付 API（Payout API）用于商户主动向受益人账户出款，是游戏、电商、劳务结算等场景的常见能力。SoPay 文档提供多国 商户代付接口 说明，包括 印度代付 API、泰国代付 API、巴基斯坦代付 API 等；本文概括 跨境代付 API 的共性，并链接到各国技术页。
代付 API 是什么
Payout API 通常包含：
- 创建代付：提交金额、商户订单号、受益人信息、回调地址
- 查询代付：按
platform_order_no或merchant_order_no查询状态 - 异步通知：终态时 POST JSON 至商户
notifyUrl/callback_url - 签名验签：请求与回调均需按 签名规范 处理
SoPay 代付为 平台 API，底层清算由平台对接 支付渠道 完成；商户无需直接调用银行或钱包原生出款接口。
多国代付文档入口
| 国家/地区 | 专题 / 说明 | 技术文档 |
|---|---|---|
| 印度 | 印度支付 API | 印度代付 API |
| 泰国 | 泰国支付 API | 泰国代付 API |
| 巴基斯坦 | 巴基斯坦支付 API | 巴基斯坦代付 API |
| 中国 | — | 中国代付 |
各国字段差异示例：印度强调 IFSC 与银行账号；泰国 Open API 形态含 payee_bank_code；巴基斯坦可能通过 metadata 指定渠道。请以对应 overview 为准。
典型集成流程
- 商户服务端构造 JSON，按该国规范签名
- 调用
POST .../payout/create（路径以 各国总览 为准） - 保存平台返回的订单号，状态一般为
processing - 实现 回调 接口：验签 → 更新业务 → 返回
200+OK - 必要时调用查询接口做对账
安全与合规提示
- 不要在客户端存放私钥或调用代付 API
- 不要在未验签的回调上直接加钱/减钱
- 不要对商户或用户承诺固定到账时间、成功率或费率；以平台返回与合同为准
- 代付金额与受益人信息需符合您所在司法辖区及平台 KYC/AML 要求
与代收 API 的关系
Payin 负责收款入商户钱包或记账；Payout 负责从商户可用余额出款。部分国家提供 商户钱包 查询（见 印度总览）。资金规则以平台与合同为准。
常见问题（FAQ）
创建代付需要哪些必填字段？
各国不同。印度见 印度代付；泰国见 泰国代付；巴基斯坦见 巴基斯坦代付。
查询接口传哪个订单号？
Open API 形态常见 platform_order_no 与 merchant_order_no 二选一（见泰国/印度查询章节）。Header 签名形态请以该国文档为准。
回调重复推送怎么办？
按订单号 幂等 更新状态；成功响应 OK 后平台才会停止重试（见 回调指南）。
跨境代付 API 是否一个接口走全球？
否。文档按国家拆分，币种与字段在各国 overview 中定义。