版本	更改日期	作者	版本變化
1.0	2013-04-22	周穎	初稿
1.1	2013-04-24	周穎	去掉商品名稱(chēng)、商品描述
1.7	2013-06-21	周穎	增加支付幣種、匯率
1.8	2013-07-26	周穎	增加幣種 修改商品名稱(chēng)、商品描述為1000
1.9	2013-08-20	周穎	api收單版本升級(jí)為1.1 2.4   頁(yè)面回調(diào)新增errCode、errMsg 4.2通知商戶(hù)接口新增errCode、errMsg
2.0	2013-08-21	周穎	網(wǎng)關(guān)版本升級(jí)為1.2 2.3   商戶(hù)提交訂單接口修改內(nèi)容：     新增賬單地址、收貨地址 3.3   商戶(hù)訂單支付接口修改內(nèi)容： 支付ip改為非空 支付郵箱改為非空 持卡人郵箱改為非空 收貨國(guó)家、收貨州/城市改為非空 姓名改成姓、名及加簽字段 新增設(shè)備指紋deviceFingerprintID及加簽
2.0	2013/9/5	周穎	下單IP改為非空
2.1	2013/10/22	周穎	新增8.api 快遞單上傳接口
2.2	2013/10/31	周穎	根據(jù)運(yùn)營(yíng)、風(fēng)控要求修改以下可空字段為不可空 互聯(lián)網(wǎng)收款業(yè)務(wù)： billFirstName billLastName billAdderess billPostalCode billCountry billState billCity billEmail billPhoneNumber shippingFirstName shippingLastName shippingAdderess shippingPostalCode shippingCity shippingEmail shippingPhoneNumber registerUserEmail registerTime registerIp registerTerminal orderIp orderTerminal API收款業(yè)務(wù)： billName billAdderess billPostalCode billCompany billCountry billState billCity billEmail billPhoneNumber shippingAdderess shippingPostalCode shippingcompany shippingCity shippingEmail shippingPhoneNumber deviceFingerprintID registerUserEmail registerTime registerIp registerTerminal orderIp orderTerminal
2.2	2013/12/10	4.2.1	resultCode 新增新返回類(lèi)型

 
 

1     文檔說(shuō)明

1.1   功能描述

通過(guò)MasaPay的支付渠道，付款者可以直接付款給商戶(hù)，其中商戶(hù)網(wǎng)站標(biāo)價(jià)使用乾匯支持的幣種，付款者付款用貨幣類(lèi)型為相關(guān)支付方式支持的幣種。

1.2   閱讀對(duì)象

MasaPay互聯(lián)網(wǎng)支付商戶(hù)接口文檔是面向具有一定的網(wǎng)站開(kāi)發(fā)能力，了解ASP，PHP，JAVA，ASP.NET等開(kāi)發(fā)語(yǔ)言中的一種及SQL數(shù)據(jù)庫(kù)語(yǔ)言的網(wǎng)站開(kāi)發(fā)，維護(hù)和管理人員。

2     互聯(lián)網(wǎng)收款業(yè)務(wù)

2.1   功能概要

商戶(hù)提交訂單接口實(shí)現(xiàn)：商戶(hù)向MasaPay互聯(lián)網(wǎng)收單系統(tǒng)提交訂單信息和明細(xì)信息。
通知商戶(hù)接口實(shí)現(xiàn)：在交易支付成功后，通知商戶(hù)系統(tǒng)訂單支付成功。

2.2   系統(tǒng)交互

圖2.1系統(tǒng)交互圖

2.3   商戶(hù)提交訂單接口

發(fā)起方：商戶(hù)系統(tǒng)
接收方：MasaPay互聯(lián)網(wǎng)收單系統(tǒng)
提交方式：POST
生產(chǎn)提交地址：https://mas.masapay.com/mas/receiveMerchantOrder.htm
測(cè)試提交地址：https://mas-sandbox.masapay.com/mas/receiveMerchantOrder.htm
提交參數(shù)：

	參數(shù)	參數(shù)名稱(chēng)		數(shù)據(jù)類(lèi)型	參數(shù)說(shuō)明		是否可空
	基本參數(shù)
	version	版本號(hào)		String(4)	網(wǎng)關(guān)版本號(hào)，此版本為1.2		不可空
	merchantId	商戶(hù)號(hào)		String(32)	商戶(hù)開(kāi)戶(hù)時(shí)由MasaPay分配		不可空
	charset	編碼字符集		String(10)	如gbk，gb2312，utf-8，Shift-JIS		不可空
	language	語(yǔ)言		String(2)	cn中文 en 英文 ru俄文 jp日文		不可空
	signType	簽名方式		String(8)	SHA256，MD5可選		不可空
	業(yè)務(wù)參數(shù)
	merchantOrderNo	商戶(hù)訂單號(hào)		String(256)	合作商戶(hù)網(wǎng)站唯一訂單號(hào)，確保在商戶(hù)系統(tǒng)唯一。		不可空
	goodsName	商品名稱(chēng)		String(1000)	商品名稱(chēng)		不可空
	goodsDesc	商品描述		String(2000)	格式為：商品名稱(chēng)1^商品規(guī)格1^購(gòu)買(mǎi)數(shù)量1^商品單價(jià)1^商品展示網(wǎng)址1|商品名稱(chēng)2^商品規(guī)格2^購(gòu)買(mǎi)數(shù)量2^商品單價(jià)2^商品展示網(wǎng)址2|……		不可空
	currencyCode	幣種		String(3)	CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門(mén)元, MYR馬來(lái)西亞, NZD新西蘭元, CHF瑞士法郎, THB泰銖, TWD新臺(tái)幣, KRW韓元, INR印度盧比, CAD加元, AUD澳元, HKD港幣, GBP英鎊, EUR歐元		不可空
	orderAmount	訂單金額		String(18)	整型數(shù)字 除了日元、韓元為元，其他幣種為分		不可空
	payMode	支付方式		String(2)	直連必填 10 國(guó)際信用卡 20 本地第三方支付 30 線(xiàn)下匯款 90 銀聯(lián)支付		可空
	orgCode	付款機(jī)構(gòu)代碼		String(10)	直連必填 國(guó)際信用卡：VISA，MASTER，JCB，AME，DINERSCLUB,DISCOVER 本地第三方支付：WEBMONEY，QIWI，WALLETONE，PAYON 線(xiàn)下匯款：WESTERNUNION , MONEYGRAM 銀聯(lián)支付：UPOP		可空
	payerAuth	是否做收款人信息驗(yàn)證		String(1)	Y驗(yàn)證N不驗(yàn)證，默認(rèn)不驗(yàn)證		可空
	directFlag	是否直連		String(1)	N非直連D直連E內(nèi)嵌		不可空
	allowDuplicate	是否可重復(fù)支付		String(1)	Y允許N不允許，默認(rèn)不允許		可空
	submitTime	提交時(shí)間		String(14)	年月日時(shí)分秒 如：20121117020101		不可空
	expiryTime	失效時(shí)間		String(14)	年月日時(shí)分秒 如：20121117020101		可空
	pageUrl	前臺(tái)回調(diào)URL		String(256)	用于在用戶(hù)支付完成后跳轉(zhuǎn)回商戶(hù)指定的URL		不可空
	bgUrl	通知URL		String(256)	通知商戶(hù)訂單支付結(jié)果的地址		不可空
	ext1	擴(kuò)展字段		String(256)	通知商戶(hù)訂單支付處理結(jié)果時(shí)回傳該參數(shù)。不能包含=，&等特殊字符		可空
	ext2	擴(kuò)展字段		String(256)	通知商戶(hù)訂單支付處理結(jié)果時(shí)回傳該參數(shù)。不能包含=，&等特殊字符		可空
	remark	備注		String(256)	用于商戶(hù)的特定業(yè)務(wù)信息的傳遞，只有商戶(hù)與masapay約定傳遞此參數(shù)才有效。 格式：參數(shù)名1^參數(shù)值1|參數(shù)名2^參數(shù)值2|		可空
賬單信息
billFirstName		賬單名	String(100)			賬單名		不可空
billLastName		賬單姓	String(100)			賬單姓		不可空
billAdderess		賬單地址	String(200)			賬單地址		不可空
billPostalCode		賬單郵編	String(20)			不超過(guò)20位		不可空
billCompany		公司名稱(chēng)	String(200)			公司名稱(chēng)		可空
billCountry		賬單國(guó)家	String(20)			賬單國(guó)家ISO Standard Country Codes		不可空
billState		賬單州省	String(20)			美國(guó)、加拿大必填，其他國(guó)家可空 two-character state,province, or territory codes.		不可空
billCity		賬單城市	String(20)			賬單城市		不可空
billEmail		賬單郵箱	String(100)			賬單郵箱		不可空
billPhoneNumber		賬單電話(huà)號(hào)碼	String(20)			純數(shù)字，不超過(guò)20位		不可空
收貨信息
shippingFirstName		收貨人名	String(100)			收貨人名		不可空
shippingLastName		收貨人姓	String(100)			收貨人姓		不可空
shippingAdderess		收貨人地址	String(200)			收貨人地址		不可空
shippingPostalCode		收貨人郵編	String(20)			不超過(guò)20位		不可空
shippingCompany		收貨人公司名稱(chēng)	String(200)			收貨人公司名稱(chēng)		不可空
shippingCountry		收貨人國(guó)家	String(20)			國(guó)家ISO Standard Country Codes		不可空
shippingState		收貨人州省	String(20)			美國(guó)、加拿大必填，其他國(guó)家可空 two-character state,province, or territory codes.		不可空
shippingCity		收貨人城市	String(20)			收貨人城市		不可空
shippingEmail		收貨人郵箱	String(100)			收貨人郵箱		不可空
shippingPhoneNumber		收貨人電話(huà)號(hào)碼	String(20)			純數(shù)字，不超過(guò)20位		不可空
	風(fēng)控參數(shù)
	registerUserId	注冊(cè)用戶(hù)ID		String(20)	商戶(hù)網(wǎng)站客戶(hù)唯一標(biāo)識(shí)號(hào)		可空
	registerUserEmail	用戶(hù)注冊(cè)郵箱		String(60)	用戶(hù)注冊(cè)郵箱地址		不可空
	registerTime	注冊(cè)時(shí)間		String(14)	年月日時(shí)分秒 如：20121117020101		不可空
	registerIp	注冊(cè)IP		String(20)	如：[202.96.209.16]		不可空
	registerTerminal	注冊(cè)終端設(shè)備		String(20)	00 PC 01手機(jī) 02其他		不可空
	orderIp	下單IP		String(20)	付款人下單時(shí)IP地址 如：[202.96.209.16]		不可空
	orderTerminal	終端設(shè)備		String(20)	付款人下單時(shí)終端設(shè)備 00 PC 01手機(jī) 02其他		不可空
	ext3	擴(kuò)展		String(256)	擴(kuò)展字段		可空
	ext4	擴(kuò)展		String(256)	擴(kuò)展字段		可空
	signMsg	簽名		String(256)	參見(jiàn)簽名元素說(shuō)明		不可空

參與簽名元素說(shuō)明：
version=1.2&merchantId=88800033122&charset=utf-8&language=en&signType=SHA256&merchantOrderNo=10000121&goodsName=女士服裝&goodsDesc=商品名稱(chēng)1^商品規(guī)格1^購(gòu)買(mǎi)數(shù)量1^商品單價(jià)1^商品展示網(wǎng)址1|商品名稱(chēng)2^商品規(guī)格2^購(gòu)買(mǎi)數(shù)量2^商品單價(jià)2^商品展示網(wǎng)址2&currencyCode=USD&orderAmount=1000&payMode=20&orgCode=WEBMONEY&directFlag=D&allowDuplicate=N&submitTime=20121117020101&expiryTime=20121117030101&pageUrl=https://www.masapay.com&bgUrl=https://www.masapay.com&key={key}
簽名方法示例說(shuō)明：
詳情參考附錄8.1簽名方法示例說(shuō)明

2.4   頁(yè)面回調(diào)

發(fā)起方：互聯(lián)網(wǎng)收單子系統(tǒng)
接收方：商戶(hù)系統(tǒng)
通知地址：商戶(hù)下單時(shí)提供的pageUrl+POST請(qǐng)求
參數(shù)：

參數(shù)	參數(shù)名稱(chēng)	數(shù)據(jù)類(lèi)型	參數(shù)說(shuō)明	是否可空
業(yè)務(wù)參數(shù)
merchantOrderNo	商戶(hù)訂單號(hào)	String(64)	合作商戶(hù)網(wǎng)站唯一訂單號(hào)，請(qǐng)確保在商戶(hù)系統(tǒng)中唯一	不可空
masapayOrderNo	交易流水號(hào)	String(16)	MasaPay系統(tǒng)交易流水號(hào)	不可空
currencyCode	幣種	String(3)	CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門(mén)元, MYR馬來(lái)西亞, NZD新西蘭元, CHF瑞士法郎, THB泰銖, TWD新臺(tái)幣, KRW韓元, INR印度盧比, CAD加元, AUD澳元, HKD港幣, GBP英鎊, EUR歐元	不可空
orderAmount	訂單金額	String(18)	單位元	不可空
payCurrencyCode	支付幣種	String(3)	CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門(mén)元, MYR馬來(lái)西亞, NZD新西蘭元, CHF瑞士法郎, THB泰銖, TWD新臺(tái)幣, KRW韓元, INR印度盧比, CAD加元, AUD澳元, HKD港幣, GBP英鎊, EUR歐元	不可空
payAmount	支付金額	String(18)	單位元	不可空
rates	匯率	String(20)	精確到小數(shù)點(diǎn)后5位	不可空
resultCode	處理結(jié)果	String(4)	10 支付成功 11支付失敗12支付中	不可空
errCode	錯(cuò)誤代碼	String(10)	失敗時(shí)返回的錯(cuò)誤代碼	可空
errMsg	錯(cuò)誤信息	String(256)	失敗時(shí)返回的錯(cuò)誤信息	可空
signMsg	簽名字符串	String(256)	參見(jiàn)簽名元素說(shuō)明	不可空

備注：
最終支付結(jié)果請(qǐng)以通知為準(zhǔn)。

3     API收款業(yè)務(wù)

3.1   功能概要

商戶(hù)提交訂單接口實(shí)現(xiàn)：商戶(hù)向MasaPay API收單系統(tǒng)提交訂單信息和支付信息。

3.2   系統(tǒng)交互

圖3.1系統(tǒng)交互圖

3.3   商戶(hù)訂單支付接口

3.3.1        請(qǐng)求

發(fā)起方：商戶(hù)系統(tǒng)
接收方：MasaPay API收單系統(tǒng)
生產(chǎn)提交地址：https://open.masapay.com/masapi/order/ReceiveMerchantOrder?wsdl
測(cè)試提交地址：https://open-sandbox.masapay.com/masapi/order/ReceiveMerchantOrder?wsdl
提交參數(shù)：

參數(shù)	參數(shù)名稱(chēng)	數(shù)據(jù)類(lèi)型		參數(shù)說(shuō)明	是否可空
基本參數(shù)
version	版本號(hào)	String(4)		網(wǎng)關(guān)版本號(hào)，此版本為1.2			不可空
merchantId	商戶(hù)號(hào)	String(32)		商戶(hù)開(kāi)戶(hù)時(shí)由MasaPay分配			不可空
charset	編碼字符集	String(10)		如gbk，gb2312，utf-8，Shift-JIS			不可空
language	語(yǔ)言	String(2)		cn中文 en 英文 ru俄文 jp日文			不可空
signType	簽名方式	String(8)		SHA256，MD5可選			不可空
業(yè)務(wù)參數(shù)
merchantOrderNo	商戶(hù)訂單號(hào)	String(256)		合作商戶(hù)網(wǎng)站唯一訂單號(hào)，確保在商戶(hù)系統(tǒng)唯一。			不可空
goodsName	商品名稱(chēng)	String(1000)		商品名稱(chēng)			不可空
goodsDesc	商品描述	String(2000)		格式為：商品名稱(chēng)1^商品規(guī)格1^購(gòu)買(mǎi)數(shù)量1^商品單價(jià)1^商品展示網(wǎng)址1|商品名稱(chēng)2^商品規(guī)格2^購(gòu)買(mǎi)數(shù)量2^商品單價(jià)2^商品展示網(wǎng)址2|……			不可空
currencyCode	幣種	String(3)	CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門(mén)元, MYR馬來(lái)西亞, NZD新西蘭元, CHF瑞士法郎, THB泰銖, TWD新臺(tái)幣, KRW韓元, INR印度盧比, CAD加元, AUD澳元, HKD港幣, GBP英鎊, EUR歐元			不可空
orderAmount	訂單金額	String(18)	整型數(shù)字 除了日元、韓元為元，其他幣種為分			不可空
payerAuth	是否做收款人信息驗(yàn)證	String(1)		Y驗(yàn)證N不驗(yàn)證，默認(rèn)不驗(yàn)證			可空
allowDuplicate	是否可重復(fù)支付	String(1)		Y允許N不允許，默認(rèn)不允許			可空
submitTime	提交時(shí)間	String(14)		年月日時(shí)分秒 如：20121117020101			不可空
expiryTime	失效時(shí)間	String(14)		年月日時(shí)分秒 如：20121117020101			可空
bgUrl	通知URL	String(256)		通知商戶(hù)訂單支付結(jié)果的地址			不可空
ext1	擴(kuò)展字段	String(256)		通知商戶(hù)訂單支付處理結(jié)果時(shí)回傳該參數(shù)。不能包含=，&等特殊字符			可空
ext2	擴(kuò)展字段	String(256)		通知商戶(hù)訂單支付處理結(jié)果時(shí)回傳該參數(shù)。不能包含=，&等特殊字符			可空
remark	備注	String(256)		用于商戶(hù)的特定業(yè)務(wù)信息的傳遞，只有商戶(hù)與masapay約定傳遞此參數(shù)才有效。 格式：參數(shù)名1^參數(shù)值1|參數(shù)名2^參數(shù)值2|			可空
支付參數(shù)
payMode	支付方式	String(2)		10 國(guó)際信用卡			不可空
orgCode	付款機(jī)構(gòu)代碼	String(10)		國(guó)際信用卡： VISA，MASTER，JCB，AME，DINERSCLUB,DISCOVER			不可空
cardNumber	持卡人卡號(hào)	String(19)		純數(shù)字，不超過(guò)19位			不可空
cardHolderFirstName	持卡人名	String(100)		持卡人名			不可空
cardHolderLastName	持卡人姓	String(100)		持卡人姓			不可空
cardExpirationMonth	卡有效月份	String(2)		純數(shù)字，不超過(guò)2位			不可空
cardExpirationYear	卡有效年份	String(4)		純數(shù)字，不超過(guò)4位			不可空
securityCode	安全碼	String(3)		純數(shù)字，不超過(guò)3位			不可空
cardHolderEmail	持卡人郵箱	String(100)		持卡人郵箱			不可空
cardHolderPhoneNumber	持卡人手機(jī)	String(20)		純數(shù)字，不超過(guò)20位			可空
payExt1	支付擴(kuò)展1	String(100)		備用			可空
payExt2	支付擴(kuò)展2	String(100)		備用			可空
賬單信息
billName	賬單姓名	String(100)		賬單姓名			不可空
billAdderess	賬單地址	String(200)		賬單地址			不可空
billPostalCode	賬單郵編	String(20)		不超過(guò)20位			不可空
billCompany	公司名稱(chēng)	String(200)		公司名稱(chēng)			不可空
billCountry	賬單國(guó)家	String(20)		賬單國(guó)家ISO Standard Country Codes			不可空
billState	賬單州省	String(20)		美國(guó)、加拿大必填，其他國(guó)家可空 two-character state,province, or territory codes.			不可空
billCity	賬單城市	String(20)		賬單城市			不可空
billEmail	賬單郵箱	String(100)		賬單郵箱			不可空
billPhoneNumber	賬單電話(huà)號(hào)碼	String(20)		純數(shù)字，不超過(guò)20位			不可空
收貨信息
shippingName	收貨人姓名	String(100)		收貨人姓名			不可空
shippingAdderess	收貨人地址	String(200)		收貨人地址			不可空
shippingPostalCode	收貨人郵編	String(20)		不超過(guò)20位			不可空
shippingCompany	收貨人公司名稱(chēng)	String(200)		收貨人公司名稱(chēng)			不可空
shippingCountry	收貨人國(guó)家	String(20)		國(guó)家ISO Standard Country Codes			不可空
shippingState	收貨人州省	String(20)		美國(guó)、加拿大必填，其他國(guó)家可空 two-character state,province, or territory codes.			不可空
shippingCity	收貨人城市	String(20)		收貨人城市			不可空
shippingEmail	收貨人郵箱	String(100)		收貨人郵箱			不可空
shippingPhoneNumber	收貨人電話(huà)號(hào)碼	String(20)		純數(shù)字，不超過(guò)20位			不可空
風(fēng)控信息
deviceFingerprintID	設(shè)備指紋ID	String(60)		1、設(shè)備指紋ID即為session_token session_token生成規(guī)則： m+merchantId+merchantOrderNo+ submitTime 2、在頁(yè)面js里引入下面url  sandbox環(huán)境： https://h.online-metrix.net/fp/check.js?org_id=1snn5n9w&session_id=masapay1{session_token} 生產(chǎn)環(huán)境 https://h.online-metrix.net/fp/check.js?org_id=k8vif92e&session_id=masapay2{session_token}			不可空
payerName	付款人姓名	String(60)		付款人姓名			可空
payerMobile	付款人手機(jī)	String(20)		付款人手機(jī)號(hào)			可空
payerEmail	付款人郵箱	String(60)		付款人郵箱			可空
registerUserId	注冊(cè)用戶(hù)ID	String(20)		商戶(hù)網(wǎng)站客戶(hù)唯一標(biāo)識(shí)號(hào)			可空
registerUserEmail	用戶(hù)注冊(cè)郵箱	String(60)		商戶(hù)網(wǎng)站用戶(hù)注冊(cè)郵箱地址			不可空
registerTime	注冊(cè)時(shí)間	String(14)		年月日時(shí)分秒 如：20121117020101			不可空
registerIp	注冊(cè)IP	String(20)		如：[202.96.209.16]			不可空
registerTerminal	注冊(cè)終端設(shè)備	String(20)		00 PC 01手機(jī) 02其他			不可空
orderIp	下單IP	String(20)		付款人下單時(shí)IP地址 如：[202.96.209.16]			不可空
orderTerminal	終端設(shè)備	String(2)		付款人下單時(shí)終端設(shè)備 00 PC 01手機(jī) 02其他			不可空
ext3	擴(kuò)展	String(256)		擴(kuò)展字段			可空
ext4	擴(kuò)展	String(256)		擴(kuò)展字段			可空
signMsg	簽名	String(256)		參見(jiàn)簽名元素說(shuō)明			不可空

參與簽名元素說(shuō)明：
version=1.2&merchantId=88800033122&charset=utf-8&language=en&signType=SHA256&merchantOrderNo=10000121&goodsName=女士服裝&goodsDesc=商品名稱(chēng)1^商品規(guī)格1^購(gòu)買(mǎi)數(shù)量1^商品單價(jià)1^商品展示網(wǎng)址1|商品名稱(chēng)2^商品規(guī)格2^購(gòu)買(mǎi)數(shù)量2^商品單價(jià)2^商品展示網(wǎng)址2&currencyCode=USD&orderAmount=1000 &allowDuplicate=N&submitTime=20121117020101&expiryTime=20121117030101& bgUrl=https://www.masapay.com&payMode=10&orgCode=visa&cardNumber=4000000000000000&cardHolderFirstName=jerry&cardHolderLastName=jin &cardExpirationMonth=09&cardExpirationYear=14&securityCode=780&cardHolderEmail=test@masapay.com&cardHolderPhoneNumber=13788888888 &deviceFingerprintID=HJH*098&*GYUJHG& shippingCountry =US&key={key}
簽名方法示例說(shuō)明：
詳情參考附錄8.1簽名方法示例說(shuō)明

3.3.2        返回

以XML 格式將數(shù)據(jù)返回給商戶(hù)。

參數(shù)	參數(shù)名稱(chēng)	數(shù)據(jù)類(lèi)型	參數(shù)說(shuō)明	是否可空
基本參數(shù)
version	版本號(hào)	String(4)	網(wǎng)關(guān)版本號(hào)，此版本為1.2	不可空
charset	編碼字符集	String(10)	如：gbk，gb2312，utf-8，Shift-JIS	不可空
language	語(yǔ)言	String(2)	zh中文 en 英文 ru俄文 jp日文	不可空
errCode	錯(cuò)誤代碼	String(10)	失敗時(shí)返回的錯(cuò)誤代碼	可空
errMsg	錯(cuò)誤信息	String(256)	失敗時(shí)返回的錯(cuò)誤信息	可空
signType	簽名方式	String(8)	SHA256，MD5可選	不可空
業(yè)務(wù)參數(shù)
merchantOrderNo	商戶(hù)訂單號(hào)	String(64)	合作商戶(hù)網(wǎng)站唯一訂單號(hào)，請(qǐng)確保在商戶(hù)系統(tǒng)中唯一	不可空
masapayOrderNo	交易流水號(hào)	String(16)	MasaPay系統(tǒng)交易流水號(hào)	不可空
submitTime	提交時(shí)間	String(14)	商戶(hù)提交訂單的時(shí)間，年月日時(shí)分秒 如：20121117020101	不可空
dealTime	交易完成時(shí)間	String(14)	MasaPay交易完成時(shí)間，年月日時(shí)分秒，如：20121117020101	不可空
currencyCode	幣種	String(3)	CNY人民幣USD美元EUR歐元RUB盧布JPY日元	不可空
orderAmount	訂單金額	String(18)	整型數(shù)字 除了日元、韓元為元，其他幣種為分	不可空
payCurrencyCode	支付幣種	String(3)	CNY人民幣USD美元EUR歐元RUB盧布JPY日元	不可空
rates	匯率	String(20)	精確到小數(shù)點(diǎn)后5位	不可空
paidAmount	實(shí)際支付金額	String(18)	整型數(shù)字 除了日元、韓元為元，其他幣種為分	不可空
payMode	支付方式	String(2)	10 國(guó)際信用卡	不可空
orgCode	付款機(jī)構(gòu)代碼	String(10)	國(guó)際信用卡：VISA，MASTER，JCB，AME，DINERSCLUB	可空
resultCode	處理結(jié)果	String(2)	00 已受理10 支付成功 11支付失敗	不可空
riskLevel	風(fēng)險(xiǎn)等級(jí)	String(2)	00無(wú)風(fēng)險(xiǎn)，01風(fēng)控拒絕，02可疑 03交易滯留	可空
riskOccurCount	風(fēng)險(xiǎn)訂單累計(jì)數(shù)量	String(4)	風(fēng)險(xiǎn)訂單累計(jì)數(shù)量	可空
riskDesc	風(fēng)險(xiǎn)描述	String(256)	風(fēng)險(xiǎn)備注	可空
ext1	擴(kuò)展字段	String(256)	回傳原訂單商戶(hù)提交的ext1	可空
ext2	擴(kuò)展字段	String(256)	回傳原訂單商戶(hù)提交的ext2	可空
signMsg	簽名字符串	String(256)	參見(jiàn)簽名元素說(shuō)明	不可空

參與簽名元素說(shuō)明：
version=1.2&charset=utf-8&language=en&signType=SHA256&merchantOrderNo=10000121&masapayOrderNo=880111123&submitTime=20121117020101&dealTime=20121117030101&currencyCode=USD&orderAmount=1000&payCurrencyCode=CNY&rates=6.21321&paidAmount=1000&payMode=20&orgCode=WEBMONEY&resultCode=10&riskLevel=00& riskOccurCount=10&riskDesc=norisk&key={key}
簽名方法示例說(shuō)明：
詳情參考附錄8.1簽名方法示例說(shuō)明
 

4     通知商戶(hù)支付結(jié)果

4.1   功能概要

通知商戶(hù)接口實(shí)現(xiàn)：在交易支付成功后，通知商戶(hù)系統(tǒng)訂單支付成功。

4.2   通知商戶(hù)接口

4.2.1        回調(diào)商戶(hù)URL

發(fā)起方：互聯(lián)網(wǎng)收單子系統(tǒng)
接收方：商戶(hù)系統(tǒng)
通知地址：商戶(hù)下單時(shí)提供的bgUrl + POST請(qǐng)求
參數(shù)：

參數(shù)	參數(shù)名稱(chēng)	數(shù)據(jù)類(lèi)型		參數(shù)說(shuō)明	是否可空
基本參數(shù)
version	版本號(hào)	String(4)		網(wǎng)關(guān)版本號(hào)，此版本為1.2	不可空
charset	編碼字符集	String(10)		如：gbk，gb2312，utf-8，Shift-JIS	不可空
language	語(yǔ)言	String(2)		cn中文 en 英文 ru俄文 jp日文	不可空
signType	簽名方式	String(8)		SHA256，MD5可選	不可空
業(yè)務(wù)參數(shù)
merchantOrderNo	商戶(hù)訂單號(hào)	String(64)		合作商戶(hù)網(wǎng)站唯一訂單號(hào)，請(qǐng)確保在商戶(hù)系統(tǒng)中唯一	不可空
masapayOrderNo	交易流水號(hào)	String(16)		MasaPay系統(tǒng)交易流水號(hào)	不可空
submitTime	提交時(shí)間	String(14)		商戶(hù)提交訂單的時(shí)間，年月日時(shí)分秒 如：20121117020101	不可空
dealTime	交易完成時(shí)間	String(14)		MasaPay交易完成時(shí)間，年月日時(shí)分秒，如：20121117020101	不可空
currencyCode	幣種	String(3)	CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門(mén)元, MYR馬來(lái)西亞, NZD新西蘭元, CHF瑞士法郎, THB泰銖, TWD新臺(tái)幣, KRW韓元, INR印度盧比, CAD加元, AUD澳元, HKD港幣, GBP英鎊, EUR歐元		不可空
orderAmount	訂單金額	String(18)	整型數(shù)字 除了日元、韓元為元，其他幣種為分		不可空
payCurrencyCode	支付幣種	String(3)		CNY人民幣USD美元EUR歐元RUB盧布JPY日元	不可空
rates	匯率	String(20)		精確到小數(shù)點(diǎn)后5位	不可空
paidAmount	實(shí)際支付金額	String(18)		整型數(shù)字 除了日元、韓元為元，其他幣種為分	不可空
payMode	支付方式	String(2)		直連必填 10 國(guó)際信用卡 20 本地第三方支付 30 線(xiàn)下匯款 90 銀聯(lián)支付	不可空
orgCode	付款機(jī)構(gòu)代碼	String(10)		直連必填 國(guó)際信用卡：VISA，MASTER，JCB，AME，DINERSCLUB 本地第三方支付：WEBMONEY，QIWI，WALLETONE，PAYON 線(xiàn)下匯款：WESTERNUNION , MONEYGRAM 銀聯(lián)支付：UPOP	可空
resultCode	處理結(jié)果	String(2)		10 支付成功 11支付失敗 12 DM審核中	不可空
errCode	錯(cuò)誤代碼	String(10)		失敗時(shí)返回的錯(cuò)誤代碼	可空
errMsg	錯(cuò)誤信息	String(256)		失敗時(shí)返回的錯(cuò)誤信息	可空
riskLevel	風(fēng)險(xiǎn)等級(jí)	String(2)		00無(wú)風(fēng)險(xiǎn)，01風(fēng)控拒絕，02可疑 03交易滯留	可空
riskOccurCount	風(fēng)險(xiǎn)訂單累計(jì)數(shù)量	String(4)		風(fēng)險(xiǎn)訂單累計(jì)數(shù)量	可空
riskDesc	風(fēng)險(xiǎn)描述	String(256)		風(fēng)險(xiǎn)備注	可空
ext1	擴(kuò)展字段	String(256)		回傳原訂單商戶(hù)提交的ext1	可空
ext2	擴(kuò)展字段	String(256)		回傳原訂單商戶(hù)提交的ext2	可空
signMsg	簽名字符串	String(256)		參見(jiàn)簽名元素說(shuō)明	不可空

參與簽名元素說(shuō)明：
version=1.2&charset=utf-8&language=en&signType=SHA256&merchantOrderNo=10000121&masapayOrderNo=880111123&submitTime=20121117020101&dealTime=20121117030101&currencyCode=USD&orderAmount=1000&payCurrencyCode=CNY&rates=6.21321&paidAmount=1000&payMode=20&orgCode=WEBMONEY&resultCode=10&riskLevel=00& riskOccurCount=10&riskDesc=norisk&key={key}
簽名方法示例說(shuō)明：
詳情參考附錄8.1簽名方法示例說(shuō)明

4.2.2        商戶(hù)應(yīng)答

MasaPay后臺(tái)通過(guò)bgUrl通知商戶(hù)，商戶(hù)系統(tǒng)處理后，需要以字符串形式返回MasaPay系統(tǒng)，內(nèi)容如下：

返回	說(shuō)明
OK	處理成功,MasaPay系統(tǒng)收到此結(jié)果后不再進(jìn)行補(bǔ)發(fā)通知
無(wú)返回或其它字符	處理不成功, MasaPay收到此結(jié)果,系統(tǒng)通過(guò)補(bǔ)單機(jī)制再次通知

 
 

5     API收款訂單查詢(xún)業(yè)務(wù)

5.1   功能概要

商戶(hù)查詢(xún)接口實(shí)現(xiàn)：在商戶(hù)網(wǎng)站查詢(xún)?cè)贛asaPay某段時(shí)間的交易記錄或某筆交易記錄。

5.2   系統(tǒng)交互

5.3   商戶(hù)查詢(xún)接口

5.3.1        請(qǐng)求

生產(chǎn)提交地址：https://open.masapay.com/masapi/order/QueryMerchantOrder?wsdl
測(cè)試提交地址：https://open-sandbox.masapay.com/masapi/order/QueryMerchantOrder?wsdl
輸入?yún)��?shù)：

參數(shù)	參數(shù)名稱(chēng)	數(shù)據(jù)類(lèi)型	參數(shù)說(shuō)明	是否可空
基本參數(shù)
version	版本號(hào)	String(4)	網(wǎng)關(guān)版本號(hào)，此版本為1.2	不可空
merchantId	商戶(hù)號(hào)	String(32)	商戶(hù)開(kāi)戶(hù)時(shí)由MasaPay分配	不可空
charset	編碼字符集	String(10)	如gbk，gb2312，utf-8，Shift-JIS	不可空
language	語(yǔ)言	String(2)	cn中文 en 英文 ru俄文 jp日文	不可空
signType	簽名方式	String(8)	SHA256，MD5可選	不可空
業(yè)務(wù)參數(shù)
queryType	查詢(xún)方式	String(1)	0按MasaPay系統(tǒng)交易流水號(hào)單筆查詢(xún) 1 按商戶(hù)訂單號(hào)查詢(xún) 2按交易結(jié)束時(shí)間批量查詢(xún),只返回成功訂單	不可空
masapayOrderNo	交易流水號(hào)	String(16)	查詢(xún)方式為0時(shí)必填	可空
merchantOrderNo	商戶(hù)訂單號(hào)	String(64)	查詢(xún)方式為1時(shí)必填	可空
startTime	訂單提交開(kāi)始時(shí)間	String(14)	查詢(xún)方式為2時(shí)必填 年月日時(shí)分秒如：20121117020101	可空
endTime	訂單提交結(jié)束時(shí)間	String(14)	查詢(xún)方式為2時(shí)必填 年月日時(shí)分秒如：20121117020101限制時(shí)間段14天內(nèi)，跨度24小時(shí)	可空
signMsg	簽名字符串	String(256)	參見(jiàn)簽名元素說(shuō)明	不可空

備注：
如果商戶(hù)指定了重復(fù)提交，根據(jù)商戶(hù)訂單號(hào)查詢(xún)將可能會(huì)返回多條結(jié)果。
參與簽名元素說(shuō)明：
version=1.2&merchantId=88800033122&charset=utf-8&language=en&signType=SHA256&queryType=1&merchantOrderNo=10000121&key={key}
簽名方法示例說(shuō)明：
詳情參考附錄8.1簽名方法示例說(shuō)明

5.3.2        返回

以XML 格式將數(shù)據(jù)返回給商戶(hù)。

參數(shù)	參數(shù)名稱(chēng)	數(shù)據(jù)類(lèi)型	參數(shù)說(shuō)明		是否可空
基本參數(shù)
version	版本號(hào)	String(4)	網(wǎng)關(guān)版本號(hào)，此版本為1.2		不可空
merchantId	商戶(hù)號(hào)	String(32)	商戶(hù)開(kāi)戶(hù)時(shí)由MasaPay分配		不可空
charset	編碼字符集	String(10)	如：gbk，gb2312，utf-8，Shift-JIS		不可空
language	語(yǔ)言	String(2)	cn中文 en 英文 ru俄文 jp日文		不可空
signType	簽名方式	String(8)	SHA256，MD5可選		不可空
errCode	錯(cuò)誤代碼	String(10)	失敗時(shí)返回的錯(cuò)誤代碼		可空
errMsg	錯(cuò)誤信息	String(256)	失敗時(shí)返回的錯(cuò)誤信息		可空
recordCount	記錄集總條數(shù)	String(10)	記錄集總條數(shù)		不可空
signMsg	簽名字符串	String(256)	參見(jiàn)簽名元素說(shuō)明		不可空
訂單信息(list)
merchantOrderNo	商戶(hù)訂單號(hào)	String(60)	商戶(hù)系統(tǒng)唯一訂單號(hào)		不可空
masapayOrderNo	交易流水號(hào)	String(16)	MasaPay系統(tǒng)交易流水號(hào)		不可空
orderAmount	訂單金額	String(18)	整型數(shù)字 除了日元、韓元為元，其他幣種為分		不可空
orderTime	提交時(shí)間	String(14)	年月日時(shí)分秒如：20121117020101		不可空
dealTime	交易時(shí)間	String(14)	年月日時(shí)分秒如：20121117020101		不可空
status	訂單狀態(tài)	String(1)	N未支付 S支付成功 F支付失敗 I支付中 C已關(guān)閉		不可空
payMode	支付方式	String(2)	10 國(guó)際信用卡 20 本地第三方支付 30 線(xiàn)下匯款 90 銀聯(lián)支付		可空
orgCode	付款機(jī)構(gòu)代碼	String(10)	國(guó)際信用卡：VISA，MASTER，JCB，AME，DINERSCLUB 本地第三方支付：WEBMONEY，QIWI，WALLETONE，PAYON 線(xiàn)下匯款：WESTERNUNION , MONEYGRAM 銀聯(lián)支付：UPOP		可空
paidAmount	實(shí)際支付金額	String(18)	整型數(shù)字 除了日元、韓元為元，其他幣種為分		不可空
currencyCode	幣種	String(3)	CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門(mén)元, MYR馬來(lái)西亞, NZD新西蘭元, CHF瑞士法郎, THB泰銖, TWD新臺(tái)幣, KRW韓元, INR印度盧比, CAD加元, AUD澳元, HKD港幣, GBP英鎊, EUR歐元	不可空
payCurrencyCode	支付幣種	String(3)	CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門(mén)元, MYR馬來(lái)西亞, NZD新西蘭元, CHF瑞士法郎, THB泰銖, TWD新臺(tái)幣, KRW韓元, INR印度盧比, CAD加元, AUD澳元, HKD港幣, GBP英鎊, EUR歐元		不可空
rates	匯率	String(20)	精確到小數(shù)點(diǎn)后5位		不可空
riskLevel	風(fēng)險(xiǎn)等級(jí)	String(2)	00無(wú)風(fēng)險(xiǎn)，01風(fēng)控拒絕，02可疑 03交易滯留		可空
riskOccurCount	風(fēng)險(xiǎn)訂單累計(jì)數(shù)量	String(4)	風(fēng)險(xiǎn)訂單累計(jì)數(shù)量		可空
riskDesc	風(fēng)險(xiǎn)描述	String(256)	風(fēng)險(xiǎn)備注		可空
OrdersignMsg	訂單簽名字符串	String(256)	訂單記錄的加密元素		不可空

參與簽名元素說(shuō)明：
signMsg=SHA256(version=1.2&merchantId=88800033122&charset=utf-8&language=en&signType=SHA256& recordCount=1&key={key}
OrdersignMsg簽名元素說(shuō)明：
merchantOrderNo=10000121&masapayOrderNo=880111123&orderAmount=1000&orderTime=20121117020101&dealTime=20121117020101&status=S&payMode=20&orgCode=WEBMONEY&paidAmount=1000&currencyCode=USD&payCurrencyCode=CNY&rates=6.21321&riskLevel=00& riskOccurCount=10&riskDesc=norisk&key={key}
簽名方法示例說(shuō)明：
詳情參考附錄8.1簽名方法示例說(shuō)明
 

6     API退款業(yè)務(wù)

6.1   功能概要

商戶(hù)退款接口：商戶(hù)將購(gòu)買(mǎi)產(chǎn)品或服務(wù)的款項(xiàng)全部或部分退還給用戶(hù)
商戶(hù)退款通知接口：在退款成功后，通知商戶(hù)系統(tǒng)退款成功。

6.2   系統(tǒng)交互

6.3   商戶(hù)退款接口

6.3.1        請(qǐng)求

參數(shù)	參數(shù)名稱(chēng)	數(shù)據(jù)類(lèi)型	參數(shù)說(shuō)明	是否可空
基本參數(shù)
version	版本號(hào)	String(4)	網(wǎng)關(guān)版本號(hào)，此版本為1.2	不可空
merchantId	商戶(hù)號(hào)	String(32)	商戶(hù)開(kāi)戶(hù)時(shí)由MasaPay分配	不可空
charset	編碼字符集	String(10)	如gbk，gb2312，utf-8，Shift-JIS	不可空
language	語(yǔ)言	String(2)	cn中文 en 英文 ru俄文 jp日文	不可空
signType	簽名方式	String(8)	SHA256，MD5可選	不可空
業(yè)務(wù)參數(shù)
refundOrderNo	退款訂單號(hào)	String(30)	商戶(hù)生成的唯一退款流水號(hào)	不可空
merchantOrderNo	原商戶(hù)訂單號(hào)	String(64)	原商戶(hù)支付訂單號(hào)	不可空
masapayOrderNo	原MasaPay交易流水號(hào)	String(16)	原MasaPay交易流水號(hào)	可空
refundAmount	退款金額	String(18)	整型數(shù)字 除了日元、韓元為元，其他幣種為分	不可空
currencyCode	幣種	String(3)	CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門(mén)元, MYR馬來(lái)西亞, NZD新西蘭元, CHF瑞士法郎, THB泰銖, TWD新臺(tái)幣, KRW韓元, INR印度盧比, CAD加元, AUD澳元, HKD港幣, GBP英鎊, EUR歐元	不可空
refundSubmitTime	退款提交時(shí)間	String(14)	年月日時(shí)分秒 如：20121117020101	不可空
callbackUrl	回調(diào)通知URL	String(256)	通知商戶(hù)退款訂單結(jié)果的回調(diào)地址	不可空
signMsg	簽名字符串	String(256)	參見(jiàn)簽名元素說(shuō)明	不可空

參與簽名元素說(shuō)明：
version=1.2&merchantId=88800033122&charset=utf-8&language=en&signType=SHA256&refundOrderNo=0001&merchantOrderNo=10000121&masapayOrderNo=1231221&refundAmount=100&currencyCode=CNY&refundSubmitTime=20121117020101&callbackUrl=http://www.masapay.com&key={key}
簽名方法示例說(shuō)明：
詳情參考附錄8.1簽名方法示例說(shuō)明

6.3.2        返回

以XML 格式將數(shù)據(jù)返回給商戶(hù)。

參數(shù)	參數(shù)名稱(chēng)	數(shù)據(jù)類(lèi)型	參數(shù)說(shuō)明	是否可空
基本參數(shù)
version	版本號(hào)	String(4)	網(wǎng)關(guān)版本號(hào)，此版本為1.2	不可空
merchantId	商戶(hù)號(hào)	String(32)	商戶(hù)開(kāi)戶(hù)時(shí)由MasaPay分配	不可空
charset	編碼字符集	String(10)	如：gbk，gb2312，utf-8，Shift-JIS	不可空
language	語(yǔ)言	String(2)	cn中文 en 英文 ru俄文 jp日文	不可空
signType	簽名方式	String(8)	SHA256，MD5可選	不可空
signMsg	簽名字符串	String(256)	參見(jiàn)簽名元素說(shuō)明	不可空
業(yè)務(wù)參數(shù)
resultCode	退款結(jié)果	String(2)	10表示退款申請(qǐng)成功 11表示退款申請(qǐng)失敗	不可空
errorMsg	錯(cuò)誤信息	String(256)	失敗時(shí)返回的錯(cuò)誤信息	可空
refundOrderNo	退款訂單號(hào)	String(32)	與提交時(shí)退款流水號(hào)保持一致	不可空

參與簽名元素說(shuō)明：
version=1.2&merchantId=88800033122&charset=utf-8&language=en&signType=SHA256& resultCode=10& refundOrderNo=123213932&key={key}
簽名方法示例說(shuō)明：
詳情參考附錄8.1簽名方法示例說(shuō)明

6.4   退款通知接口

6.4.1        通知

發(fā)起方：互聯(lián)網(wǎng)收單子系統(tǒng)
接收方：商戶(hù)系統(tǒng)
通知地址：商戶(hù)退款時(shí)提供的noticeUrl + POST請(qǐng)求
參數(shù)：

參數(shù)	參數(shù)名稱(chēng)	數(shù)據(jù)類(lèi)型	參數(shù)說(shuō)明	是否可空
基本參數(shù)
version	版本號(hào)	String(4)	網(wǎng)關(guān)版本號(hào)，此版本為1.2	不可空
charset	編碼字符集	String(10)	如：gbk，gb2312，utf-8，Shift-JIS	不可空
language	語(yǔ)言	String(2)	cn中文 en 英文 ru俄文 jp日文	不可空
signType	簽名方式	String(8)	SHA256，MD5可選	不可空
業(yè)務(wù)參數(shù)
refundOrderNo	退款訂單號(hào)	String(64)	合作商戶(hù)網(wǎng)站唯一退款號(hào),確保在商戶(hù)系統(tǒng)中唯一	不可空
merchantOrderNo	原商戶(hù)訂單號(hào)	String(64)	原商戶(hù)訂單號(hào)	不可空
masapayOrderNo	原MasaPay交易流水號(hào)	String(16)	原MasaPay交易流水號(hào)	可空
masapayRefundOrderNo	Masapay退款流水號(hào)	String(16)	Masapay退款流水號(hào)	不可空
submitTime	提交時(shí)間	String(14)	商戶(hù)提交退款訂單的時(shí)間，年月日時(shí)分秒如：20121117020101	不可空
dealTime	交易完成時(shí)間	String(14)	MasaPay退款交易完成時(shí)間，年月日時(shí)分秒如：20121117020101	不可空
currencyCode	幣種	String(3)	CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門(mén)元, MYR馬來(lái)西亞, NZD新西蘭元, CHF瑞士法郎, THB泰銖, TWD新臺(tái)幣, KRW韓元, INR印度盧比, CAD加元, AUD澳元, HKD港幣, GBP英鎊, EUR歐元	不可空
refundAmount	退款金額	String(18)	整型數(shù)字 除了日元、韓元為元，其他幣種為分	不可空
resultCode	處理結(jié)果	String(2)	10 退款成功 11退款失敗	不可空
ext1	擴(kuò)展1	String(256)	擴(kuò)展字段	可空
ext2	擴(kuò)展2	String(256)	擴(kuò)展字段	可空
signMsg	簽名字符串	String(256)	參見(jiàn)簽名元素說(shuō)明	不可空

參與簽名元素說(shuō)明：
version=1.2&charset=utf-8&language=en&signType=SHA256&refundOrderNo=0001&merchantOrderNo=10000121&masapayOrderNo=12312312&masapayRefundOrderNo=1111111111111111&submitTime=20121117020101&dealTime=20121117020101&currencyCode=CNY&refundAmount=100&resultCode=10&key={key}
簽名方法示例說(shuō)明：
詳情參考附錄8.1簽名方法示例說(shuō)明

6.4.2        應(yīng)答

MasaPay后臺(tái)通過(guò)callbackUrl通知商戶(hù)，商戶(hù)系統(tǒng)處理后，需要以字符串形式返回MasaPay系統(tǒng)，內(nèi)容如下：

返回	說(shuō)明
OK	處理成功,MasaPay系統(tǒng)收到此結(jié)果后不再進(jìn)行補(bǔ)發(fā)通知
無(wú)返回或其它字符	處理不成功, MasaPay收到此結(jié)果,系統(tǒng)通過(guò)補(bǔ)單機(jī)制再次通知

7     API退款查詢(xún)業(yè)務(wù)

7.1   功能概要

在商戶(hù)自己的網(wǎng)站查詢(xún)?cè)贛asaPay某段時(shí)間的交易記錄或某筆交易記錄。

7.2   系統(tǒng)交互

7.3   退款查詢(xún)接口

7.3.1        請(qǐng)求

發(fā)起方：商戶(hù)系統(tǒng)
接收方：MasaPay互聯(lián)網(wǎng)收單系統(tǒng)
生產(chǎn)提交地址：
測(cè)試提交地址：
輸入?yún)��?shù)：

參數(shù)	參數(shù)名稱(chēng)	數(shù)據(jù)類(lèi)型	參數(shù)說(shuō)明	是否可空
基本參數(shù)
version	版本號(hào)	String(4)	網(wǎng)關(guān)版本號(hào)，此版本為1.2	不可空
merchantId	商戶(hù)號(hào)	String(32)	商戶(hù)開(kāi)戶(hù)時(shí)由MasaPay分配	不可空
charset	編碼字符集	String(10)	如gbk，gb2312，utf-8，Shift-JIS	不可空
language	語(yǔ)言	String(2)	cn中文 en 英文 ru俄文 jp日文	不可空
signType	簽名方式	String(8)	SHA256，MD5可選	不可空
業(yè)務(wù)參數(shù)
queryType	查詢(xún)方式	String(1)	0 按商戶(hù)訂單號(hào)單筆查詢(xún) 1 按交易結(jié)束時(shí)間批量查詢(xún)，只返回成功訂單	不可空
refundOrderNo	退款訂單號(hào)	String(30)	查詢(xún)方式為0時(shí)必填，商戶(hù)生成的唯一退款流水號(hào)	不可空
startTime	退款提交起始時(shí)間	String(14)	查詢(xún)方式為1時(shí)必填，年月日時(shí)分秒如：20121117020101	可空
endTime	退款提交結(jié)束時(shí)間	String(14)	查詢(xún)方式為1時(shí)必填，年月日時(shí)分秒如：20121117020101限制查詢(xún)時(shí)間段14天內(nèi)，跨度24小時(shí)	可空
signMsg	簽名字符串	String(256)	參見(jiàn)簽名元素說(shuō)明	不可空

參與簽名元素說(shuō)明：
version=1.2&merchantId=88800033122&charset=utf-8&language=en&signType=SHA256&queryType=0&refundOrderNo=0001&key={key}
簽名方法示例說(shuō)明：
詳情參考附錄8.1簽名方法示例說(shuō)明

7.3.2        返回

以XML 格式將數(shù)據(jù)返回給商戶(hù)。

參數(shù)	參數(shù)名稱(chēng)	數(shù)據(jù)類(lèi)型	參數(shù)說(shuō)明		是否可空
基本參數(shù)
version	版本號(hào)	String(4)	網(wǎng)關(guān)版本號(hào)，此版本為1.2		不可空
merchantId	商戶(hù)號(hào)	String(32)	商戶(hù)開(kāi)戶(hù)時(shí)由MasaPay分配		不可空
charset	編碼字符集	String(10)	如：gbk，gb2312，utf-8，Shift-JIS		不可空
language	語(yǔ)言	String(2)	cn中文 en 英文 ru俄文 jp日文		不可空
signType	簽名方式	String(8)	SHA256，MD5可選		不可空
errCode	錯(cuò)誤代碼	String(10)	失敗時(shí)返回的錯(cuò)誤代碼		可空
errMsg	錯(cuò)誤信息	String(256)	失敗時(shí)返回的錯(cuò)誤信息		可空
recordCount	記錄集總條數(shù)	String(10)			不可空
signMsg	簽名字符串	String(256)	參見(jiàn)簽名元素說(shuō)明		不可空
訂單信息(list)
refundOrderNo	退款訂單號(hào)	String(30)	商戶(hù)生成的唯一退款流水號(hào)		不可空
merchantOrderNo	原商戶(hù)訂單號(hào)	String(64)	原商戶(hù)訂單號(hào)		不可空
masapayRefundOrderNo	退款流水號(hào)	String(16)	MasaPay系統(tǒng)退款流水號(hào)		不可空
refundAmount	實(shí)際退款金額	String(18)	整型數(shù)字 除了日元、韓元為元，其他幣種為分		不可空
currencyCode	幣種	String(3)	CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門(mén)元, MYR馬來(lái)西亞, NZD新西蘭元, CHF瑞士法郎, THB泰銖, TWD新臺(tái)幣, KRW韓元, INR印度盧比, CAD加元, AUD澳元, HKD港幣, GBP英鎊, EUR歐元		不可空
submitTime	退款提交時(shí)間	String(14)	年月日時(shí)分秒如：20121117020101		不可空
dealTime	退款交易時(shí)間	String(14)	年月日時(shí)分秒如：20121117020101		不可空
status	訂單狀態(tài)	String(1)	P退款中 S退款成功 F退款失敗		不可空
OrdersignMsg	單筆訂單簽名字符串	String(256)		每筆訂單記錄的加密元素	不可空

signMsg參與簽名元素元素說(shuō)明：
version=1.2&merchantId=88800033122&charset=utf-8&language=en&signType=SHA256&recordCount=1&key={key}
OrdersignMsg參與簽名元素說(shuō)明：
refundOrderNo=0001&merchantOrderNo=10000121&masapayRefundOrderNo1111111111111111&refundAmount=100&currencyCode=CNY&submitTime=20121117020101&dealTime=20121117020101&status=P&key={key}
簽名方法示例說(shuō)明：
詳情參考附錄8.1簽名方法示例說(shuō)明
 

8     API快遞單上傳業(yè)務(wù)

8.1   功能概要

快遞單上傳接口實(shí)現(xiàn)：商戶(hù)上傳快遞單數(shù)據(jù)。

8.2   快遞單上傳接口

8.2.1        請(qǐng)求

生產(chǎn)提交地址：https://open.masapay.com/masapi/order/UploadExpressList?wsdl
測(cè)試提交地址：https://open-sandbox.masapay.com/ masapi/order/UploadExpressList?wsdl
輸入?yún)��?shù)：

參數(shù)	參數(shù)名稱(chēng)			數(shù)據(jù)類(lèi)型			參數(shù)說(shuō)明	是否可空
基本參數(shù)
version	版本號(hào)		String(4)		網(wǎng)關(guān)版本號(hào)，此版本為1.2			不可空
merchantId	商戶(hù)號(hào)		String(32)		商戶(hù)開(kāi)戶(hù)時(shí)由MasaPay分配			不可空
charset	編碼字符集		String(10)		如gbk，gb2312，utf-8，Shift-JIS			不可空
language	語(yǔ)言		String(2)		cn中文 en 英文 ru俄文 jp日文			不可空
expressCount	快遞單總數(shù)		String(10)		上傳快遞單總數(shù)量			不可空
signType	簽名方式		String(8)		SHA256，MD5可選			不可空
signMsg	簽名字符串			String(256)			參見(jiàn)簽名元素說(shuō)明	不可空
快遞單信息list
merchantOrderNo	商戶(hù)訂單號(hào)			String(64)			原商戶(hù)支付訂單號(hào)	不可空
expressDate	配送時(shí)間			String(14)			年月日時(shí)分秒如：20121117020101	不可空
etaDate	預(yù)計(jì)妥投時(shí)間			String(14)			年月日時(shí)分秒如：20121117020101	不可空
expressNo	快遞單號(hào)			String(32)			快遞公司下單時(shí)訂單號(hào)	不可空
expressCompany	快遞公司			String(60)			快遞公司名稱(chēng)	不可空
expressUrl	查單網(wǎng)址			String(200)			快遞公司查詢(xún)訂單網(wǎng)址	不可空
uploadDate	上傳時(shí)間			String(14)			年月日時(shí)分秒如：20121117020101	不可空
expressSignMsg		單筆快遞單簽名字符串	String(256)			每筆快遞單記錄的簽名字符串		不可空

備注：
商戶(hù)可以一次上傳多條訂單
參與簽名元素說(shuō)明：
signMsg=SHA256(version=1.2&merchantId=88800033122&charset=utf-8&language=en&signType=SHA256&expressCount=1&key={key})
ExpressSignMsg簽名元素說(shuō)明：
merchantOrderNo=10000121&expressDate=20121117020101&etaDate=20121117020101&expressNo=10099900101&expressCompany=順豐快遞&expressUrl=www.masapay.com&key={key}

8.2.2        返回

以XML 格式將數(shù)據(jù)返回給商戶(hù)。

參數(shù)		參數(shù)名稱(chēng)	數(shù)據(jù)類(lèi)型		參數(shù)說(shuō)明			是否可空
基本參數(shù)
version		版本號(hào)	String(4)		網(wǎng)關(guān)版本號(hào)，此版本為1.2			不可空
merchantId		商戶(hù)號(hào)	String(32)		商戶(hù)開(kāi)戶(hù)時(shí)由MasaPay分配			不可空
charset		編碼字符集	String(10)		如：gbk，gb2312，utf-8，Shift-JIS			不可空
language		語(yǔ)言	String(2)		cn中文 en 英文 ru俄文 jp日文			不可空
signType		簽名方式	String(8)		SHA256，MD5可選			不可空
errCode		錯(cuò)誤代碼	String(10)		失敗時(shí)返回的錯(cuò)誤代碼			可空
errMsg		錯(cuò)誤信息	String(256)		失敗時(shí)返回的錯(cuò)誤信息			可空
expressCount	快遞單總數(shù)		String(10)		成功收到快遞單總數(shù)量		不可空
signMsg		簽名字符串	String(256)		參見(jiàn)簽名元素說(shuō)明			不可空
未成功快遞單信息list
merchantOrderNo	商戶(hù)訂單號(hào)			String(64)		原商戶(hù)支付訂單號(hào)			不可空
expressDate	配送時(shí)間			String(14)		年月日時(shí)分秒如：20121117020101			不可空
etaDate	預(yù)計(jì)妥投時(shí)間			String(14)		年月日時(shí)分秒如：20121117020101			不可空
expressNo	快遞單號(hào)			String(32)		快遞公司下單時(shí)訂單號(hào)			不可空
expressCompany	快遞公司			String(60)		快遞公司名稱(chēng)			不可空
expressUrl	查單網(wǎng)址			String(200)		快遞公司查詢(xún)訂單網(wǎng)址			不可空
uploadDate	上傳時(shí)間			String(14)		年月日時(shí)分秒如：20121117020101			不可空
expressSignMsg		單筆快遞單簽名字符串	String(256)		每筆快遞單記錄的簽名字符串					不可空

參與簽名元素說(shuō)明：
version=1.2&merchantId=88800033122&charset=utf-8&language=en&signType=SHA256& expressCount =2&key={key}
expressSignMsg簽名元素說(shuō)明：
merchantOrderNo=10000121&expressDate=20121117020101&etaDate=20121117020101&expressNo=10099900101&expressCompany=順豐快遞&expressUrl=www.masapay.com&key={key}
 

9     附錄

9.1   簽名方法示例說(shuō)明

9.1.1        商戶(hù)提交訂單接口

簽名算法：
SHA256
參與簽名元素：
version=1.2&merchantId=88800033122&charset=utf-8&language=en&signType=SHA256&merchantOrderNo=10000121&goodsName=女士服裝&goodsDesc=商品名稱(chēng)1^商品規(guī)格1^購(gòu)買(mǎi)數(shù)量1^商品單價(jià)1^商品展示網(wǎng)址1|商品名稱(chēng)2^商品規(guī)格2^購(gòu)買(mǎi)數(shù)量2^商品單價(jià)2^商品展示網(wǎng)址2&currencyCode=USD&orderAmount=1000&payMode=20&orgCode=WEBMONEY&directFlag=D&submitTime=20121117020101&expiryTime=20121117030101&pageUrl=https://www.masapay.com&bgUrl=https://www.masapay.com&key=1234567890
使用SHA256對(duì)上述簽名元素得出的簽名結(jié)果（二進(jìn)制轉(zhuǎn)十六進(jìn)制大寫(xiě)）如下：
AD59678D5389974AB6886A3AAB6133FE0BCF1C0BA56E270B71C941F135F00BC0
提交參數(shù)示例：
version=1.2&merchantId=88800033122&charset=utf-8&language=en&signType=SHA256&merchantOrderNo=10000121&goodsName=女士服裝&goodsDesc=商品名稱(chēng)1^商品規(guī)格1^購(gòu)買(mǎi)數(shù)量1^商品單價(jià)1^商品展示網(wǎng)址1|商品名稱(chēng)2^商品規(guī)格2^購(gòu)買(mǎi)數(shù)量2^商品單價(jià)2^商品展示網(wǎng)址2&currencyCode=USD&orderAmount=1000&payMode=20&orgCode=WEBMONEY&directFlag=D&submitTime=20121117020101&expiryTime=20121117030101&pageUrl=http://www.masapay.com&bgUrl=http://www.masapay.com&ext1=&ext2=&remark=&payerName=&payerMobile=&payerEmail=&registerTime=&registerIp=&registerTerminal=&receiveName&receiveAddress=&receivePostCode=&receiveTel=&orderIp=&orderTerminal=&ext3=&ext4=&signMsg=AD59678D5389974AB6886A3AAB6133FE0BCF1C0BA56E270B71C941F135F00BC0

9.1.2        通知商戶(hù)接口

簽名算法：
SHA256
參與簽名元素：
version=1.2&charset=utf-8&language=en&signType=SHA256&merchantOrderNo=10000121&masapayOrderNo=880111123&submitTime=20121117020101&dealTime=20121117030101&currencyCode=USD&orderAmount=1000&paidAmount=1000&payMode=20&orgCode=WEBMONEY&resultCode=10&riskLevel=00&riskDesc=norisk&key=1234567890
使用SHA256對(duì)上述簽名元素得出的簽名結(jié)果（二進(jìn)制轉(zhuǎn)十六進(jìn)制大寫(xiě)）如下：
AE403619EA1D5F460F1F4819802AF9F647C3A4169BACF3F35ECF081568EC2B94
提交參數(shù)示例：
version=1.2&charset=utf-8&language=en&signType=SHA256&merchantOrderNo=10000121&masapayOrderNo=880111123&submitTime=20121117020101&dealTime=20121117030101&currencyCode=US D&orderAmount=1000&paidAmount=1000&payMode=20&orgCode=WEBMONEY&resultCode=10&riskLevel=00&riskDesc=norisk&ext1=&ext2=&signMsg=AE403619EA1D5F460F1F4819802AF9F647C3A4169BACF3F35ECF081568EC2B94

9.2   聯(lián)系人

聯(lián)調(diào)人員：周穎
聯(lián)系郵箱：zhouying@masapay.com
聯(lián)系電話(huà)：+86+21-61001361
 

9.3   約定

1、masapay在當(dāng)返回報(bào)文有errorCode的時(shí)候，masapay對(duì)返回報(bào)文不做加簽，同時(shí)masapay相關(guān)交易信息也返回為空。
 

Unitrans世聯(lián)翻譯公司在您身邊,離您近的翻譯公司,心貼心的專(zhuān)業(yè)服務(wù),專(zhuān)業(yè)的全球語(yǔ)言翻譯與信息解決方案供應(yīng)商,專(zhuān)業(yè)翻譯機(jī)構(gòu)品牌。無(wú)論在本地,國(guó)內(nèi)還是海外,我們的專(zhuān)業(yè)、星級(jí)體貼服務(wù)，為您的事業(yè)加速！世聯(lián)翻譯公司在北京、上海、深圳等國(guó)際交往城市設(shè)有翻譯基地，業(yè)務(wù)覆蓋全國(guó)城市。每天有近百萬(wàn)字節(jié)的信息和貿(mào)易通過(guò)世聯(lián)走向全球！積累了大量政商用戶(hù)數(shù)據(jù)，翻譯人才庫(kù)數(shù)據(jù)，多語(yǔ)種語(yǔ)料庫(kù)大數(shù)據(jù)。世聯(lián)品牌和服務(wù)品質(zhì)已得到政務(wù)防務(wù)和國(guó)際組織、跨國(guó)公司和大中型企業(yè)等近萬(wàn)用戶(hù)的認(rèn)可。 專(zhuān)業(yè)翻譯公司,北京翻譯公司,上海翻譯公司,英文翻譯,日文翻譯,韓語(yǔ)翻譯,翻譯公司排行榜,翻譯公司收費(fèi)價(jià)格表,翻譯公司收費(fèi)標(biāo)準(zhǔn),翻譯公司北京,翻譯公司上海。