泰国支付 API（Thailand Payment API）
SoPay 泰国支付 API（Thailand Payment API）帮助商户在 THB 场景下完成代收（Payin）、代付（Payout）与订单查询。若您正在评估 泰国支付接口、泰国支付渠道 或面向泰国用户的 Payment API 集成，本文提供能力概览与文档入口；接口参数与示例以 泰国 API 总览 为准。
泰国支付 API 是什么
Thailand Payment API 是商户与 SoPay 平台之间的 REST/Open API 集合，用于：
- 创建 Thailand Payin API 订单，向付款人收取泰铢
- 创建 Thailand Payout API 订单，向收款人出款
- 查询订单状态、处理 callback_url 异步通知
- 按 签名规范 对请求验签
泰国本地常见支付方式包括银行转账、PromptPay 等；商户通过 SoPay 统一 API 接入，无需分别对接每家 泰国支付通道。
SoPay 泰国文档中的能力
| 主题 | 说明 | 链接 |
|---|---|---|
| 环境与接入 | 网关地址、Open API 约定 | 泰国总览 |
| 代收 | 创建 / 查询 / 回调 | 泰国代收 |
| 代付 | 创建 / 查询 / 回调 | 泰国代付 |
| 签名 | RSA2、bizContent 等 | 泰国签名页 与 通用签名 |
| 回调 | 验签与 OK 响应 | 异步回调 |
部分历史文档同时存在 Open API（appId + bizContent）与 商户 API（X-Merchant-No + Header 签名）描述，请以您合同约定的版本与 泰国总览 当前章节为准。
THB 代收（Payin）
Thailand Payin API 典型步骤：商户创建订单 → 平台返回平台单号或支付指引（视通道而定）→ 用户完成支付 → 平台 POST 至 callback_url。
代收创建字段包括 order_no、金额、callback_url、付款人信息等（见 泰国代收）。THB Payment API 集成时请注意 bizContent 必须为 JSON 字符串（Open API 形态）。
THB 代付（Payout）
Thailand Payout API 用于向泰国本地银行账户或渠道支持的受益人出款。创建时需传入收款人姓名、账号、银行编码（如文档示例中的 payee_bank_code）等。
查询与回调字段命名可能为蛇形（如 platform_order_no），与创建响应中的 camelCase 并存，对接时请以实际 JSON 为准。
PromptPay 与本地渠道
PromptPay API 常作为泰国小额扫码/转账能力的统称。SoPay 文档从 商户 API 层面描述代收代付，是否在代收侧返回 PromptPay 二维码、跳转链接等，以联调返回的 data 字段为准，不在此页做能力承诺。
接入建议
常见问题（FAQ）
泰国 API 用 Open API 还是 Header 签名？
文档中存在两种描述。请以运维/商务下发的商户包与 泰国总览 当前推荐路径为准，不要混用两套鉴权。
代收和代付可以共用同一个 callback_url 吗？
通常可以，但务必在业务层按 order_no、订单类型区分处理，并做幂等。
如何查询订单？
见 泰国代付 与 泰国代收 的 Open API 查询说明（platform_order_no 与 merchant_order_no 二选一）。
英文文档在哪里？
泰国英文 API 页位于 /en/tha/*，例如 English Thailand overview。