代付订单 · 泰国

请求

代付 API 用于向受益人发起代付交易。本页为 泰国（国家码 th）的代付说明。

请求路径

域名：推荐使用统一域名 openapi.toppayment.com（路径不变）；原国别域名（如 global-th-openapi.toppayment.com）仍可用。

环境	地址
沙箱	https://openapi.toppayment.com/sandbox/th/disbursement/cash
生产	https://openapi.toppayment.com/th/disbursement/cash

代付 bankCode 见 地区支付说明 — 泰国。

请求头

字段	必填	类型	描述
Content-Type	M	String	HTTP内容类型规范 固定值：application/json 正确解析请求所必需

请求体

字段	必填	类型	描述
mchNo	M	String(32)	商户编号
orderNum	M	String(50)	商户订单号
amount	M	Number(32,8)	交易金额
bankCode	M	String(32)	银行代码（泰国）
bankCard	M	String(50)	收款账号
accountName	M	String(50)	收款账户名
description	O	String(255)	备注
feeType	M	Number(0/1)	手续费类型 0 : 代付金额内扣除(实际到账金额=下单金额-手续费) 1 : 手续费另计(实际到账金额=下单金额)
downNotifyUrl	M	String(164)	异步通知地址
timestamp	M	String(13)	毫秒时间戳
sign	M	String	签名，见 签名规则

请求示例

{
  "mchNo": "{{mchNo}}",
  "orderNum": "THPPROD1234561",
  "amount": 100,
  "bankCode": "KBANK",
  "bankCard": "09270322921",
  "accountName": "maya",
  "description": "test",
  "feeType": 1,
  "downNotifyUrl": "https://test-domain.com/test/catchStatus",
  "timestamp": "1749451858772",
  "sign": "按签名规则生成后替换"
}

响应

HTTP响应

字段	必填	类型	描述
Content-Type	M	String	HTTP响应内容类型规范 固定值：application/json 指示JSON响应格式

响应字段

字段	必填	类型	描述
success	M	Boolean	请求是否成功 true：成功，false：失败
code	M	String	响应状态码 9999：成功 其他：请根据订单状态码判断
msg	O	String	响应消息
timeStamp	M	Number	响应时间戳（毫秒级）
data	M	Object	响应数据对象
orderNum	M	String	商户订单号
platOrderNum	M	String	平台订单号
amount	M	Number	交易金额
fee	M	Number	手续费
feeType	M	Number	手续费类型
status	M	Number	交易状态
statusMsg	M	String	状态消息
bankCode	M	String	银行代码（泰国） 含义见 地区支付说明 — 泰国
bankCard	M	String	银行卡号/账户号
accountName	M	String	收款人账户名称
description	O	String	描述

响应示例

{
  "success": true,
  "code": "9999",
  "msg": "SUCCESS",
  "timeStamp": 1767772957433,
  "data": {
    "orderNum": "THPPROD1234561",
    "platOrderNum": "TRANS2008811496544403456",
    "amount": 100,
    "fee": 2,
    "feeType": 1,
    "status": 1,
    "statusMsg": "ORDER_RECEIVED_PROCESSING",
    "bankCode": "KBANK",
    "bankCard": "09270322921",
    "accountName": "maya",
    "description": "test"
  }
}

通知

HTTP请求

字段	必填	类型	描述
Content-Type	M	String	HTTP请求内容类型规范 固定值：application/json

通知体

字段	必填	类型	描述
platOrderNum	M	String	平台订单号
version	M	String	版本号
orderNum	M	String	商户订单号
amount	M	Number	交易金额
fee	M	Number	手续费
feeType	M	Number	手续费类型
status	M	Number	交易状态 取值见 交易状态码
statusMsg	M	String	状态消息
bankCode	M	String	银行代码（泰国）
bankCard	M	String	银行卡号/账户号
accountName	M	String	账户名
description	O	String	描述
sign	M	String	回调签名

返回

SUCCESS

通知示例

{
  "platOrderNum": "TRANS2008812168572567552",
  "version": "v1",
  "orderNum": "THPPROD12345648",
  "amount": 111,
  "fee": 3,
  "feeType": 1,
  "status": 2,
  "statusMsg": "supplement success!",
  "bankCode": "KBANK",
  "bankCard": "09270322921",
  "accountName": "maya",
  "description": "test",
  "sign": "示例签名"
}