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+"&amp;");//键值进行组合

}

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

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

代收

基本信息

请求参数

返回数据

代收通知

基本信息

请求参数

代收查询

基本信息

请求参数

返回数据

data

代付

基本信息

请求参数

返回数据

代付通知

基本信息

请求参数

代付查询

基本信息

请求参数

返回数据

data

查询余额

基本信息

请求参数

返回数据

泰国银行编码

Kbank方式

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