Path: /api/pay
Method: POST
接口描述:
签名规则:
必输字段按ASCII码表升序排序,排序后再按照键值对进行组合,用&来进行连接,如key1=val1&key2=val2……,再将字符串进行MD5加密并转换为小写,得到的32位小写加密结果赋值到sign字段。
参考代码(JAVA):
ArrayList keys = new ArrayList(map.keySet());
Collections.sort(keys);//字段升序排序
StringBuffer stb=new StringBuffer();
for (Object s : keys) {
String o = map.get(s).toString();
if (o==null||"".equals(o)){
break;
}
stb.append(s+"="+ o+"&");//键值进行组合
}
stb.append("key="+key);//拼接key
MD5.md5(stb.toString());//MD5值小写
参考代码(PHP):
function sign($arr,$keys) {
ksort($arr);
$signStr;
foreach ($arr as $key => $val) {
if (!empty($key)) {
$signStr = $signStr . $key . "=" . $val . "&";
}
}
$signStr = $signStr . "key=" . $keys;
echo $signStr;
return md5($signStr);
}
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/x-www-form-urlencoded | 是 |
Body
参数名称 | 参数类型 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
mid | string | 是 | 商户账号 | |
amount | number | 是 |
200.00 => 200 200.50 => 200.5 200.05 => 200.05 |
金额(泰铢元) |
channel | string | 否 |
qr:扫码 transfer:网银转账 不填写默认为:qr |
渠道编码 |
orderId | string | 是 | 订单id | |
notifyUrl | string | 是 | 商户回调地址 | |
extra | any | 是 | 商户携带数据,建议是会员信息 | |
sign | string | 是 | 签名(详见签名规则) |
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
status | string | 必须 | 状态码(0-成功) | ||
msg | string | 必须 | 信息(错误会带上错误信息) | ||
data | string | 必须 | 支付地址 |
Path: 代收填写的回调地址
Method: POST
接口描述:
成功返回“SUCCESS”
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/json | 是 |
Body
参数名称 | 参数类型 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
account | string | 是 | 商户账号 | |
status | number | 是 | 状态(1 支付成功 2 失败或者作废) | |
orderId | string | 是 | 代收填写的订单id(商户订单号) | |
amount | number | 是 |
代收实际金额增加0.05的浮动,300以下的整数金额上浮0-0.05,300以上的金额下浮0-0.05 例如: 50为:50-50.05 300为:299.95-300 |
实际支付的金额(可能会有0.05的浮动,泰铢元) |
extra | any | 是 | 代收携带的数据,建议是会员信息 | |
sign | string | 是 | 签名(详见签名规则) |
Path: /api/payOrderInfo
Method: POST
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/x-www-form-urlencoded | 是 |
Body
参数名称 | 参数类型 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
mid | string | 是 | 商户账号 | |
orderId | string | 是 | 代收填写的订单id(商户订单号) | |
sign | string | 是 | 签名(详见签名规则) |
名称 | 类型 | 是否必须 | 默认值 | 备注 |
---|---|---|---|---|
status | string | 必须 | 状态码(0-成功) | |
msg | string | 必须 | 信息(错误会带上错误信息) | |
data | string | 必须 | 订单数据 |
名称 | 类型 | 是否必须 | 默认值 | 备注 |
---|---|---|---|---|
id | string | 必须 | 平台订单号 | |
account | string | 必须 | 商户账户 | |
orderId | string | 必须 | 商户订单Id | |
payAmount | string | 必须 | 代收金额(泰铢元) | |
fee | string | 必须 | 手续费 | |
amount | string | 必须 | 商户到账(泰铢元) | |
status | string | 必须 | 状态 0-等待支付 1-支付成功 2-失败或过期 | |
unit | string | 必须 | THB | 货币单位 |
notify | string | 必须 | 通知数据 | |
notify | string | 必须 |
url:商户通知URL status: 通知状态,0-未通知,1-通知成功,2-通知失败 num: 通知次数,最大5次 msg: 通知商户返回的信息 time: 上一次通知时间 extra: 商户自定义通知数据 |
通知数据 |
createTime | string | 必须 | 订单生成时间 | |
completeTime | string | 必须 | 订单完成时间 |
Path: /api/withdraw
Method: POST
接口描述:
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/x-www-form-urlencoded | 是 |
Body
参数名称 | 参数类型 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
mid | string | 是 | 商户账号 | |
orderId | string | 是 | 订单id | |
amount | number | 是 |
200.00 => 200 200.50 => 200.5 200.05 => 200.05 |
金额(泰铢元) |
channel | string | 否 |
qr:扫码(请确保收款人手机号真实,乱填写固定等不真实情况导致的掉单转错问题由商户承担) transfer:网银转账 不填写默认为:qr |
渠道编码 |
notifyUrl | string | 是 | 回调地址 | |
bankCode | string | 是 | 银行编码 | |
account | string | 是 | 代付人账号 | |
name | string | 是 | 代付人名称 | |
phone | string | 是 | 代付人手机号(要求真实,否则代付可能不成功) | |
extra | string | 否 | 代付携带的数据,建议是会员信息 | |
sign | string | 是 | 签名(详见签名规则) |
名称 | 类型 | 是否必须 | 默认值 | 备注 |
---|---|---|---|---|
status | string | 必须 | 状态码(0-成功) | |
msg | string | 必须 | 信息(错误会带上错误信息) |
Path: 代付所填写的回调地址
Method: POST
接口描述:
成功返回“SUCCESS”
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/json | 是 |
Body
参数名称 | 参数类型 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
account | string | 是 | 商户账号 | |
status | number | 是 | 状态( 1 代付成功 2 失败或者作废) | |
orderId | string | 是 | 订单id | |
amount | number | 是 | 金额(泰铢元) | |
extra | string | 否 | 代付时携带数据,建议是会员信息 | |
sign | string | 是 | 签名(详见签名规则) |
Path: /api/withdrawOrderInfo
Method: POST
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/x-www-form-urlencoded | 是 |
Body
参数名称 | 参数类型 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
mid | string | 是 | 商户账号 | |
orderId | string | 是 | 代付填写的订单id(商户订单号) | |
sign | string | 是 | 签名(详见签名规则) |
名称 | 类型 | 是否必须 | 默认值 | 备注 |
---|---|---|---|---|
status | string | 必须 | 状态码(0-成功) | |
msg | string | 必须 | 信息(错误会带上错误信息) | |
data | string | 必须 | 订单数据 |
名称 | 类型 | 是否必须 | 默认值 | 备注 |
---|---|---|---|---|
id | string | 必须 | 平台订单号 | |
account | string | 必须 | 商户账户 | |
orderId | string | 必须 | 商户订单Id | |
withdrawAmount | string | 必须 | 代付金额(泰铢元) | |
fee | string | 必须 | 手续费 | |
amount | string | 必须 | 商户扣除金额(泰铢元) | |
status | string | 必须 | 状态 0-等待代付 1-代付成功 2-失败或过期 | |
unit | string | 必须 | THB | 货币单位 |
notify | string | 必须 | 通知数据 | |
notify | string | 必须 |
url:商户通知URL status: 通知状态,0-未通知,1-通知成功,2-通知失败 num: 通知次数,最大5次 msg: 通知商户返回的信息 time: 上一次通知时间 extra: 商户自定义通知数据 |
通知数据 |
createTime | string | 必须 | 订单生成时间 | |
completeTime | string | 必须 | 订单完成时间 |
Path: /api/getBalance
Method: POST
接口描述:
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/x-www-form-urlencoded | 是 |
Body
参数名称 | 参数类型 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
mid | string | 是 | 商户账号 | |
sign | string | 是 | 签名(详见签名规则) |
名称 | 类型 | 是否必须 | 默认值 | 备注 |
---|---|---|---|---|
status | string | 必须 | 状态码(0-成功) | |
msg | string | 必须 | 信息(错误会带上错误信息) | |
data | object | 必须 | ||
├─ balance | string | 必须 | 余额 | |
├─ unit | string | 必须 | 货币单位 |
JSON数据:
{
"001": "KBank",
"003": "BBL",
"018": "CIMB",
"017": "Krungsri",
"004": "KTB",
"020": "LH Bank",
"010": "SCB",
"013": "SCBT",
"007": "TMBThanachart",
"016": "UOB",
"022": "GSB",
"023": "KKP",
"024": "Citibank N.A.",
"025": "GHBA",
"026": "BAAC",
"027": "MHCB",
"028": "ibank",
"029": "Tisco",
"030": "ICBC Thai",
"031": "Thai Credit",
"032": "SMBC",
"033": "HSBC",
"034": "BNPP",
"035": "DEUTSCHE BANK AG ",
"036": "Bank of China",
"038": "INDIAN OVERSEAS BANK",
"039": "SME"
}
编码 | 简称 | 全称 |
---|---|---|
001 | KBank | KASIKORNBANK |
003 | BBL | BANGKOK BANK |
018 | CIMB | CIMB Bank |
017 | Krungsri | BANK OF AYUDHYA |
004 | KTB | KRUNG THAI BANK |
020 | LH Bank | Land and Houses Bank |
010 | SCB | Siam Commercial Bank |
013 | SCBT | Standard Chartered Bank (Thai) |
007 | TMBThanachart | TMBThanachart Bank PCL |
016 | UOB | United Overseas Bank (Thai) |
022 | GSB | Government Savings Bank |
023 | KKP | KIATNAKIN PHATRA BANK PUBLIC COMPANY LIMITED |
024 | Citibank N.A. | Citibank N.A. |
025 | GHBA | Government Housing Bank |
026 | BAAC | Bank for Agriculture and Agricultural Cooperatives |
027 | MHCB | Mizuho Bank Bangkok Branch |
028 | ibank | Islamic Bank Of Thailand |
029 | Tisco | Tisco Bank Public Company Limited |
030 | ICBC Thai | ICBC Thai |
031 | Thai Credit | Thai Credit Retail Bank Public Company Limited |
032 | SMBC | SUMITOMO MITSUI BANKING |
033 | HSBC | HONGKONG AND SHANGHAI BANKING |
034 | BNPP | BNP PARIBAS, BANGKOK BRANCH |
035 | DEUTSCHE BANK AG | DEUTSCHE BANK AG |
036 | Bank of China | Bank of China |
038 | INDIAN OVERSEAS BANK | INDIAN OVERSEAS BANK |
039 | SME | SMALL AND MEDIUM ENTERPRISE DEVELOPMENT BANK OF TH |