泰国支付接口

1264字约4分钟

注意

阅读该接口文档前，务必先查看 接口说明

限额

交易类型	限额(单位:THB)
代收	QR扫码：1-8000 TM钱包：1-1000
付款	1-49999

账户余额查询

URL：/common/openapi/account/balance

param 参数：

参数名	必选	固定值	说明
country	是	THA	国家编码
currency	是	THB	币种

request

{
    "param": {
        "country": "THA",
        "currency": "THB",
    },
    "sign": "Gw6D0kuWlnngLMiSxQQ2Dz2ciZz4LUZ7gWA8dRkEbcsE+UoiTOy6T3g6vNvGUlz+vPV2aRHKZ6aPBh0PaJkWW36T/lf8qId4D9uh8lFeTe7zW0+hTgTnN9YmruA6rlRNCo9QytbMRk6qkEZh1PZ2NrFnC77FhYVEVdOk6bIOv/vnGo1RVpbmsO+Gw+tPnvkQ1jvVDEHUlKgnAFGYa7+oWw8eClh9T4Ob7ZUPI0Z+dhefAmEX+z8DCyUxZrtbgA0li21KW2TmErIiRJQxep/f4quWRoTKkPziiMefKo1jFgbyL/gVzgkp91YaMMyk1QJKW1UoZ8iqHKNMI6pmvBCk8g=="

}

response

{
    "code": 200,
    "message": "",
    "data": {
        "merId": "",
        "merName": "",
        "currency": "",
        "amountTotal": "0.00",
        "freeAmount": "1085178690.00",
        "unrecordedAmount": "0.00",
        "freezeAmount": "1085178690.00",
        "frzBal": "0.00"
    }
}

返回data参数说明

参数名	类型	说明
merId	string	商户号
merName	string	商户名称
currency	string	币种
amountTotal	BigDecimal	总金额
freeAmount	BigDecimal	可用金额
unrecordedAmount	BigDecimal	在途金额
freezeAmount	BigDecimal	冻结金额

代付接口

代付下单

URL：/tha/openapi/disbursement/transfer

body请求参数：

参数名	必选	类型	说明
amount	是	string	代付金额必填，支持两位小数 (小数点后尾数不带0, 例如: 禁止传输 123.40, 应传: 123.4)
bankCode	是	string	银行编号必填，参考代付支持银行卡编码
cardNumber	是	string	客户银行卡号必填
channelNo	是	string	通道编号（608593）
country	是	string	国家编码(THA)
currency	是	string	币种(THB)
customerName	是	string	客户名称
dateTime	是	string	时间格式：yyyMMddHHmmss
email	否	string	用户邮箱
merOrderNo	是	string	订单编号
mobile	否	string	用户真实手机号码
notifyUrl	是	string	回调地址必填
sign	是	string	签名

request，仅为参考示例，具体信息以表格为准

{
	"amount": "",
	"bankCode": "",
	"cardNumber": "",
	"channelNo": "",
	"country": "",
	"currency": "",
	"customerName": "",
	"dateTime": "",
	"email": "",
	"merOrderNo": "",
	"mobile": "",
	"notifyUrl": "",
	"sign": ""
}

response

{
	"code": 0,
	"data": {
		"merchantOrderNo": "",
		"plaOrderNo": 0,
		"sign": "",
		"status": "",
		"timestamp": 0
	},
	"message": ""
}

返回data参数说明

参数名	类型	说明
merchantNo	string	平台商户号
plaOrderNo	string	平台订单号
sign	string	签名
status	string	交易状态('PENDING','COMPLETED','FAILED')

银行编码(代付)

bankCode	bankName
BBL	泰国盘谷银行
Kbank	泰国开泰银行
KTB	泰国泰京银行
TMB	泰国军人银行
SCB	泰国汇商银行
CITI	花旗银行
CIMBT	联昌国际银行
UOBT	泰国大华银行
BAY	泰国大城银行
GSB	泰国政府储蓄银行
GHB	泰国政府住房银行
BAAC	泰国农业合作银行
TISCO	泰国铁士古银行
KKP	泰国丘细见银行
LHB	泰国土地房屋银行

代收接口

支付视频

收款

URL：/tha/openapi/payment/generate

body请求参数：

参数名	必选	类型	说明
amount	是	string	代收金额必填，支持两位小数 (小数点后尾数不带0, 例如: 禁止传输 123.40, 应传: 123.4)
channelNo	是	string	通道编号（固定值：608593）
country	是	string	国家编码（固定值：THA）
currency	是	string	币种（固定值：THB）
dateTime	是	long	时间戳
merOrderNo	是	string	订单编号
notifyUrl	是	string	异步回调地址
redirectUrl	是	string	支付完成跳转地址
orderType	是	string	固定值：0
transAccNo	否	string	用户付款卡号(真实)使用网银转账时必传
type	否	string	银行简称
payType	否	string	支付模式，当method为EwalletPay时，必传，可选值：TM（truemoney钱包）
method	否	string	不传默认为qrPay，使用truemoney钱包需传EwalletPay
sign	是	string	签名

request，仅为参考示例，具体信息以表格为准

{
	"amount": "",
	"channelNo": "",
	"country": "",
	"currency": "",
	"dateTime": 0,
	"merOrderNo": "",
	"notifyUrl": "",
	"orderType": "",
	"transAccNo": "",
	"type": "",
	"method": "",
       "payType": "",
       "sign": ""
}

response

{
	"code": 0,
	"data": {
		"fee": 0,
		"merchantOrderNo": "",
		"payData": "",
		"payUrl": "",
		"plaOrderNo": 0,
		"sign": "",
		"status": "",
		"timestamp": 0
	},
	"message": ""
}

返回data参数说明

参数名	类型	说明
fee	number	手续费
merchantOrderNo	string	商户订单号
payData	string	支付信息
payUrl	string	XwinPay提供的二维码支付页面
plaOrderNo	string	平台订单号
sign	string	验签
status	string	支付状态

订单回调通知

URL: 系统交易完成或余额不足时会发送回调到notify_url回调通知地址

响应: 接受请求后请返回“success”字符串给我们

请求方式：

method: POST
Content Type: application/json

body参数：

参数名	类型	说明
amount	string	订单金额
fee	string	手续费
merchantNo	string	平台商户号
merchantOrderNo	string	商户订单号
merchantPayTime	string	商户交易时间
plaOrderNo	string	平台订单号
plaStatusTime	string	平台订单状态流转时间
status	string	支付状态('PENDING','COMPLETED','FAILED')
errorCode	string	错误编码(status为FAILED时有值)
errorMessage	string	错误信息(status为FAILED时有值)
sign	string	签名使用平台公钥验签(取reqeust body里的数据，)

request

{
	"merchantNo": "58256833",
	"merchantOrderNo": "5825683320230508569",
	"plaOrderNo": "1223050839733260230",
	"status": "COMPLETED",
	"amount": "100000",
	"merchantPayTime": "2023-05-08 11:14:01",
	"plaStatusTime": "2023-05-08 11:14:30",
	"fee": "200",
	"sign": "bXE1dI7TrjmRvIGrcfgBqMKhSCsTAtvtoZBd4GIl6NQOqd/8qGudTmX3WJn37NX+v8ehaSGUNSa+4ocAzWQlNQMqJ/OH2Hd+mViXjR2+6n3q4WsvHTzoDGR0VT85jT2cjR421RnnzaC/eLy/02Zx/j7y2snodVnzi6L3RfiY2gM="
}

订单状态查询

URL：/tha/openapi/orderStatus

body请求参数：

参数名	必选	类型	说明
sign	是	string	签名
plaOrderNo	是	Long	平台订单号

返回data参数说明

参数名	类型	说明
amount	string	订单金额
channelCode	string	支付渠道
merchantNo	string	平台商户号
merchantOrderNo	string	商户订单号
merchantPayTime	string	商户交易时间
plaOrderNo	long	平台订单号
plaStatusTime	string	平台订单状态流转时间
status	string	支付状态('PENDING','COMPLETED','FAILED')