跳到主要内容

创建收款单(泰国)

创建泰铢(THB)收款订单接口。

请求资讯

  • 请求 URL: /gateway/api/v2/payments
  • 请求方式: POST
  • Content-Type: application/json;charset=utf-8

请求参数

参数名必选类型说明
platform_idString(6)商户 ID
service_idString(7)服务 ID
payment_cl_idString(64)商户订单号
amountInteger(10)金额(分)
notify_urlString(256)交易结果通知地址
nameString(64)汇款人户名(实名制时必填)。泰国个人与法人户名普遍超过 16 字元,请勿截断
bank_nameString(64)银行代码,银行列表(实名制时必填)
last_numberString(32)汇款人账号(实名制时必填)
user_idString(32)商户端用户/会员标识,仅存储用于商户内部对账,不在查询与回调中返回
request_timeInteger(10)请求时间(秒)
sign_typeString(16)签名类型,固定值 HMAC-SHA256
signString(32|64)订单签名

服务 ID

  • SVC0044 TrueMoney
  • SVC0045 银行网关
  • SVC0046 银行扫码
  • SVC0065 PROMPT PAY

以上为系统支援的服务项目,实际开通的服务以商务确认为准。

返回示例

成功返回

{
"error_code": "0000",
"data": {
"link": "https://pay.example.com/cashier/PM00000102",
"payment_id": "PM00000102",
"payment_cl_id": "order_20260112001",
"amount": 10000
}
}

备注

  • 交易金额单位为泰铢(分),请乘以 100 传入
  • 请求时间使用 Unix timestamp,单位为秒
  • payment_id 格式为 {环境标识}PM{8 位数字},环境标识由系统分配、长度不固定。请以字符串完整保存,勿写死长度或前缀
  • 若该笔交易需要付款人实名资料而请求未带 name / bank_name / last_number,订单会先导向本系统的资料补填页由付款人自行填写。此时查询接口返回 status = -1(待付款人补充资料),订单仍然有效,请继续轮询,勿视为失败
  • 交易结果将通知至 notify_url,参数规范见 交易结果通知