Skip to content

代收订单创建 ​

商户通过此接口发起代收(收款)订单,平台会生成对应的支付链接或支付参数,供用户完成付款。


接口信息 ​

  • 接口地址: /payin/create
  • 请求方法: POST
  • Content-Type: application/json; charset=utf-8

请求 Header 参数 ​

参数名必填类型说明
merchantNo是string商户号
sign是string签名(参见全局说明)

请求 Body 参数 ​

参数名称必传类型说明
timestamp是Long毫秒时间戳
merchantOrderNo是string商户订单号(唯一,字母+数字,最大长度32)
amount是string金额,(最多保留两位小数)
payType是string支付类型:QR(聚合扫码),
bankCode否string银行编码。当 payType 为 BANK 时必传
accountNo否string银行账户。当 payType 为 BANK 时必传
accountName是string收款人姓名 / 付款人姓名
mobile是string收款人电话。格式:以 06, 08 或 09 开头
notifyUrl是string异步通知回调地址
email否string邮箱
remark否string备注
expireSeconds否string过期时间,单位秒,范围 30~3600,不传使用默认配置

返回示例 ​

json
{
  "code": 1,
  "msg": "success",
  "data": {
    "merchantNo": "M1639466186292",
    "merchantOrderNo": "202112151143188593456",
    "platOrderNo": "876324486452871168",
    "amount": "220.00",
    "fee": "0",
    "payType": "payType",
    "payUrl": "payUrl",
    "qrcode": "qrcode",
    "expireTime": "2026-05-05 11:11:11",
    "status": "1"
  }
}
json
{
  "code": 0,
  "msg": "param merchant error"
}

返回参数说明 ​

参数名类型说明
codenumber1 成功,0 失败
msgstring消息说明
dataobject成功时返回的数据体
└ merchantNostring商户号
└ merchantOrderNostring商户订单号
└ platOrderNostring平台订单号
└ amountstring金额
└ feestring手续费
└ payTypestring支付类型:THAI_DYNAMIC_QR, BANK
└ payUrlstring支付跳转链接 / 唤起参数 (payUrl)
└ qrcodestring二维码内容(没有返回该字段请使用 payUrl)
└ expireTimestring过期时间(格式:yyyy-MM-dd HH:mm:ss)
└ statusstring状态:0 已创建,1 处理中,2 失败,3 成功

银行编码 (Bank Code) 列表 ​

当 payType 为 BANK 时,bankCode 必须为以下列表中的其中之一:

支持时间段说明:

  • 全天:00:00:00 - 23:59:59
  • 白天:07:00:00 - 23:59:59
  • 夜间:00:00:00 - 06:59:59
bankCode银行全称 (EN)银行全称 (TH)支持时间段
BAACBANK FOR AGRICULTURE AND AGRICULTURAL COOPERATIVESธ. เพื่อการเกษตรและสหกรณ์การเกษตร全天
BAYBANK OF AYUDHYA PUBLIC COMPANY LIMITEDธ. กรุงศรีอยุธยา จำกัด (มหาชน)全天
BBLBANGKOK BANK PUBLIC COMPANY LTD.ธ. กรุงเทพ จำกัด (มหาชน)全天
CIMBTCIMB THAI BANK PUPBLIC COMPANY LTD.ธ. ซีไอเอ็มบี ไทย จำกัด (มหาชน)全天
CLICXCLICX BANKCLICX BANK全天
EXIMEXIM BANKธนาคารเพื่อการส่งออกและนำเข้าแห่งประเทศไทย全天
GHBTHE GOVERNMENT HOUSING BANKธ. อาคารสงเคราะห์全天
GSBTHE GOVERNMENT SAVINGS BANKธ. ออมสิน全天
ISLAMICISLAMIC BANKธนาคารอิสลามแห่งประเทศไทย全天
KBANKKASIKORNBANK PUBLIC COMPANY LTD.ธ. กสิกรไทย จำกัด (มหาชน)全天
KTBKRUNG THAI BANK PUBLIC COMPANY LTD.ธ. กรุงไทย จำกัด (มหาชน)全天
LHBANKLAND AND HOUSES BANK PUBLIC COMPANY LIMITEDธ. แลนด์แอนด์เฮ้าส์ จำกัด (มหาชน)全天
SCBSIAM COMMERCIAL BANK PUBLIC COMPANY LTDธ. ไทยพาณิชย์ จำกัด (มหาชน)全天
SCBTSTANDARD CHARTERED BANK (THAI) PUBLIC COMPANY LIMITEDธ. สแตนดาร์ดชาร์เตอร์ด (ไทย) จำกัด (มหาชน)全天
SMESME BANKธ. พัฒนาวิสาหกิจขนาดกลางและขนาดย่อม全天
TCRTHE THAI CREDIT RETAIL BANK PUBLIC COMPANY LIMITEDธ. ไทยเครดิต เพื่อรายย่อย จำกัด (มหาชน)全天
TISCOTISCO BANK PUBLIC COMPANY LIMITEDธ. ทิสโก้ จำกัด (มหาชน)全天
TTBTMBTHANACHART BANK PUBLIC COMPANY LIMITEDธ. ทหารไทยธนชาต จำกัด (มหาชน)全天
UOBTUNITED OVERSEAS BANK (THAI) PUBLIC COMPANY LIMITEDธ. ยูโอบี จำกัด (มหาชน)全天