• API接口
    • 代收
    • 代收通知
    • 代收查询
    • 代付
    • 代付通知
    • 代付查询
    • 查询余额
    • 泰国银行编码

AzPay API 地址
https://api.azpay.top

代收

基本信息

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/json 是

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 string 否 商户携带数据,建议是会员信息
sign string 是 签名(详见签名规则)

返回数据

名称 类型 是否必须 默认值 备注 其他信息
status string 必须 状态码(0-成功,其他为失败)
0-成功
1-参数错误
2-重复请求
3-商户错误
4-前面错误
5-订单号已存在
6-系统错误
7-金额不在限制范围内
8-商户配置不正确
10-渠道错误
11-产品调度错误
105-系统维护
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.5的浮动,300以下的整数金额上浮0-0.5,300以上的金额下浮0-0.5
例如:
50为:50-50.5
300为:299.5-300
实际支付的金额(可能会有0.5的浮动,泰铢元),以实际支付金额为准!
preAmount number 是 代收提交金额
extra string 否 代收携带的数据,建议是会员信息
sign string 是 签名(详见签名规则)

代收查询

基本信息

Path: /api/payOrderInfo

Method: POST

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json 是

Body

参数名称 参数类型 是否必须 示例 备注
mid string 是 商户账号
orderId string 是 代收填写的订单id(商户订单号)
sign string 是 签名(详见签名规则)

返回数据

名称 类型 是否必须 默认值 备注
status string 必须 状态码(0-成功,其他为失败)
msg string 必须 信息(错误会带上错误信息)
data string 必须 订单数据

data

名称 类型 是否必须 默认值 备注
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/json 是

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-提交成功,其他为失败)
0-提交成功
1-参数错误
2-重复请求
3-商户错误
4-代付余额不足
5-签名错误
6-订单号已存在
7-金额不在限制范围内
8-银行编码错误
9-商户配置错误
10-渠道错误
11-产品调度错误
12-收款人信息格式错误
13-收款人支行错误
105-系统维护
108-IP不在白名单内
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/json 是

Body

参数名称 参数类型 是否必须 示例 备注
mid string 是 商户账号
orderId string 是 代付填写的订单id(商户订单号)
sign string 是 签名(详见签名规则)

返回数据

名称 类型 是否必须 默认值 备注
status string 必须 状态码(0-成功,其他为失败)
msg string 必须 信息(错误会带上错误信息)
data string 必须 订单数据

data

名称 类型 是否必须 默认值 备注
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/json 是

Body

参数名称 参数类型 是否必须 示例 备注
mid string 是 商户账号
sign string 是 签名(详见签名规则)

返回数据

名称 类型 是否必须 默认值 备注
status string 必须 状态码(0-成功,其他为失败)
msg string 必须 信息(错误会带上错误信息)
data object 必须
├─ balance string 必须 余额
├─ unit string 必须 货币单位

泰国银行编码

Kbank方式

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

Build by AZ.