商户对接代收付API文档

1.基本说明

（1）数据格式。所有请求和返回都采用POST，数据格式都是JSON。
服务器返回的数据格式为：
（2）签名。对于所有待签名参数，对所有参数{key=value}采用字典序排序，然后以&符号拼接成一个字符串source，最后拼上md5key，source与md5key之间不需要任何符号相连。对于异步通知的回调，请勿采用写死参数的方式来验证签名，由于系统的更新，可能会有参数的增减，请对所有参数进行动态排序再签名。
示例,待签名参数：
（3）异步通知。代收和代付都会有异步通知。异步通知地址请在商户后台提前设置， 否则没有通知。代收仅通知成功的订单；代付无论订单是失败还是成功，都会有通 知。

（4）订单状态。

参数名	订单状态	说明
orderState	0	初始化
	1	成功
	2	失败
	3	处理中
	4	关闭
	5	打款退回

2. 代收

2.1 代收下单

请求地址： 商户对接API/api/payIn
参数列表：

参数	备注	类型	必填
merchNo	商户号	String	Y
orderNo	订单号	String(10,35)	Y
amount	金额,如100.00	String	Y
currency	币种	String	Y
sign	签名	String	Y

Request body:
Success Response Body：
Fail Response Body：

2.2 代收异步通知

如果订单支付成功，会以POST方式通知到商户后台设置的代收通知地址。 商户收到异步通知后，返回 "ok" 字符串以证明收到通知，否则系统将会进行多次通知。

(代收请以订单金额amount回调，不是真实金额realmoAmount。因为有时候我们会给玩家优惠)

2.3 代收查询

请求地址商户对接API/api/payIn/query
请求参数：

参数名	说明	类型	必填
merchNo	商户号	String	Y
orderNo	商户订单号	String	Y
sign	签名	String	Y

Request body:
Success Response Body：
Fail Response Body：

3. 余额查询

请求地址：商户对接API/api/balance
请求参数：

参数名	说明	类型	必填
merchNo	商户号	String	Y
timestamp	时间戳毫秒	String	Y
currency	币种	String	Y
sign	签名	String	Y

Request body:
Success Response Body：
Fail Response Body：

4. 代付

4.1 代付下单

请求地址：商户对接API/api/payOut
参数列表：

参数名	说明	类型	必填
merchNo	商户号	String	Y
orderNo	订单号	String(10, 35)	Y
amount	金额,如900.00	String	Y
currency	币种	String	Y
acctName	收款人姓名	firstName@lastName	Y
acctCode	银行编码/IFSC/GCASH/ PAYMAYA	String	Y
acctNo	银行账号/GCASH/PAYMAYA/UPI等账号	String	Y
mobile	收款人手机	String	Y
sign	签名	String	Y

Request Body：
Success Response Body Fail Response Body：

4.2 代付回调

代付最终处理结果会以POST方式, 通知到商户在后台设置的代付通知地址，商户需要返回 "ok" 字符串证明收到通知,否则系统会多次进行通知。
Request body：

4.3 代付查询

请求地址：商户对接API/api/payOut/query
请求参数：

参数名	说明	类型	必填
merchNo	商户号	String	Y
orderNo	商户订单号	String	Y
sign	签名	String	Y

Request body:
Success Response Body：
Fail Response Body：