版本	更改日期	作者	版本變化
1.0	2013-04-22	周穎	初稿
1.1	2013-04-24	周穎	去掉商品名稱、商品描述
1.7	2013-06-21	周穎	增加支付幣種、匯率
1.8	2013-07-26	周穎	增加幣種 修改商品名稱、商品描述為1000
1.9	2013-08-20	周穎	api收單版本升級為1.1 2.4   頁面回調(diào)新增errCode、errMsg 4.2通知商戶接口新增errCode、errMsg
2.0	2013-08-21	周穎	網(wǎng)關(guān)版本升級為1.2 2.3   商戶提交訂單接口修改內(nèi)容：     新增賬單地址、收貨地址 3.3   商戶訂單支付接口修改內(nèi)容： 支付ip改為非空 支付郵箱改為非空 持卡人郵箱改為非空 收貨國家、收貨州/城市改為非空 姓名改成姓、名及加簽字段 新增設(shè)備指紋deviceFingerprintID及加簽
2.0	2013/9/5	周穎	下單IP改為非空
2.1	2013/10/22	周穎	新增8.api 快遞單上傳接口
2.2	2013/10/31	周穎	根據(jù)運(yùn)營、風(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 新增新返回類型

 
 

1     文檔說明

1.1   功能描述

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

1.2   閱讀對象

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

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

2.1   功能概要

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

2.2   系統(tǒng)交互

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

2.3   商戶提交訂單接口

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

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

參與簽名元素說明：
version=1.2&merchantId=88800033122&charset=utf-8&language=en&signType=SHA256&merchantOrderNo=10000121&goodsName=女士服裝&goodsDesc=商品名稱1^商品規(guī)格1^購買數(shù)量1^商品單價(jià)1^商品展示網(wǎng)址1|商品名稱2^商品規(guī)格2^購買數(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}
簽名方法示例說明：
詳情參考附錄8.1簽名方法示例說明

2.4   頁面回調(diào)

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

參數(shù)	參數(shù)名稱	數(shù)據(jù)類型	參數(shù)說明	是否可空
業(yè)務(wù)參數(shù)
merchantOrderNo	商戶訂單號	String(64)	合作商戶網(wǎng)站唯一訂單號，請確保在商戶系統(tǒng)中唯一	不可空
masapayOrderNo	交易流水號	String(16)	MasaPay系統(tǒng)交易流水號	不可空
currencyCode	幣種	String(3)	CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門元, MYR馬來西亞, 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澳門元, MYR馬來西亞, 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é)果請以通知為準(zhǔn)。

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

3.1   功能概要

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

3.2   系統(tǒng)交互

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

3.3   商戶訂單支付接口

3.3.1        請求

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

參數(shù)	參數(shù)名稱	數(shù)據(jù)類型		參數(shù)說明	是否可空
基本參數(shù)
version	版本號	String(4)		網(wǎng)關(guān)版本號，此版本為1.2			不可空
merchantId	商戶號	String(32)		商戶開戶時(shí)由MasaPay分配			不可空
charset	編碼字符集	String(10)		如gbk，gb2312，utf-8，Shift-JIS			不可空
language	語言	String(2)		cn中文 en 英文 ru俄文 jp日文			不可空
signType	簽名方式	String(8)		SHA256，MD5可選			不可空
業(yè)務(wù)參數(shù)
merchantOrderNo	商戶訂單號	String(256)		合作商戶網(wǎng)站唯一訂單號，確保在商戶系統(tǒng)唯一。			不可空
goodsName	商品名稱	String(1000)		商品名稱			不可空
goodsDesc	商品描述	String(2000)		格式為：商品名稱1^商品規(guī)格1^購買數(shù)量1^商品單價(jià)1^商品展示網(wǎng)址1|商品名稱2^商品規(guī)格2^購買數(shù)量2^商品單價(jià)2^商品展示網(wǎng)址2|……			不可空
currencyCode	幣種	String(3)	CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門元, MYR馬來西亞, 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)		通知商戶訂單支付結(jié)果的地址			不可空
ext1	擴(kuò)展字段	String(256)		通知商戶訂單支付處理結(jié)果時(shí)回傳該參數(shù)。不能包含=，&等特殊字符			可空
ext2	擴(kuò)展字段	String(256)		通知商戶訂單支付處理結(jié)果時(shí)回傳該參數(shù)。不能包含=，&等特殊字符			可空
remark	備注	String(256)		用于商戶的特定業(yè)務(wù)信息的傳遞，只有商戶與masapay約定傳遞此參數(shù)才有效。 格式：參數(shù)名1^參數(shù)值1|參數(shù)名2^參數(shù)值2|			可空
支付參數(shù)
payMode	支付方式	String(2)		10 國際信用卡			不可空
orgCode	付款機(jī)構(gòu)代碼	String(10)		國際信用卡： VISA，MASTER，JCB，AME，DINERSCLUB,DISCOVER			不可空
cardNumber	持卡人卡號	String(19)		純數(shù)字，不超過19位			不可空
cardHolderFirstName	持卡人名	String(100)		持卡人名			不可空
cardHolderLastName	持卡人姓	String(100)		持卡人姓			不可空
cardExpirationMonth	卡有效月份	String(2)		純數(shù)字，不超過2位			不可空
cardExpirationYear	卡有效年份	String(4)		純數(shù)字，不超過4位			不可空
securityCode	安全碼	String(3)		純數(shù)字，不超過3位			不可空
cardHolderEmail	持卡人郵箱	String(100)		持卡人郵箱			不可空
cardHolderPhoneNumber	持卡人手機(jī)	String(20)		純數(shù)字，不超過20位			可空
payExt1	支付擴(kuò)展1	String(100)		備用			可空
payExt2	支付擴(kuò)展2	String(100)		備用			可空
賬單信息
billName	賬單姓名	String(100)		賬單姓名			不可空
billAdderess	賬單地址	String(200)		賬單地址			不可空
billPostalCode	賬單郵編	String(20)		不超過20位			不可空
billCompany	公司名稱	String(200)		公司名稱			不可空
billCountry	賬單國家	String(20)		賬單國家ISO Standard Country Codes			不可空
billState	賬單州省	String(20)		美國、加拿大必填，其他國家可空 two-character state,province, or territory codes.			不可空
billCity	賬單城市	String(20)		賬單城市			不可空
billEmail	賬單郵箱	String(100)		賬單郵箱			不可空
billPhoneNumber	賬單電話號碼	String(20)		純數(shù)字，不超過20位			不可空
收貨信息
shippingName	收貨人姓名	String(100)		收貨人姓名			不可空
shippingAdderess	收貨人地址	String(200)		收貨人地址			不可空
shippingPostalCode	收貨人郵編	String(20)		不超過20位			不可空
shippingCompany	收貨人公司名稱	String(200)		收貨人公司名稱			不可空
shippingCountry	收貨人國家	String(20)		國家ISO Standard Country Codes			不可空
shippingState	收貨人州省	String(20)		美國、加拿大必填，其他國家可空 two-character state,province, or territory codes.			不可空
shippingCity	收貨人城市	String(20)		收貨人城市			不可空
shippingEmail	收貨人郵箱	String(100)		收貨人郵箱			不可空
shippingPhoneNumber	收貨人電話號碼	String(20)		純數(shù)字，不超過20位			不可空
風(fēng)控信息
deviceFingerprintID	設(shè)備指紋ID	String(60)		1、設(shè)備指紋ID即為session_token session_token生成規(guī)則： m+merchantId+merchantOrderNo+ submitTime 2、在頁面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ī)號			可空
payerEmail	付款人郵箱	String(60)		付款人郵箱			可空
registerUserId	注冊用戶ID	String(20)		商戶網(wǎng)站客戶唯一標(biāo)識號			可空
registerUserEmail	用戶注冊郵箱	String(60)		商戶網(wǎng)站用戶注冊郵箱地址			不可空
registerTime	注冊時(shí)間	String(14)		年月日時(shí)分秒 如：20121117020101			不可空
registerIp	注冊IP	String(20)		如：[202.96.209.16]			不可空
registerTerminal	注冊終端設(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)		參見簽名元素說明			不可空

參與簽名元素說明：
version=1.2&merchantId=88800033122&charset=utf-8&language=en&signType=SHA256&merchantOrderNo=10000121&goodsName=女士服裝&goodsDesc=商品名稱1^商品規(guī)格1^購買數(shù)量1^商品單價(jià)1^商品展示網(wǎng)址1|商品名稱2^商品規(guī)格2^購買數(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&[email protected]&cardHolderPhoneNumber=13788888888 &deviceFingerprintID=HJH*098&*GYUJHG& shippingCountry =US&key={key}
簽名方法示例說明：
詳情參考附錄8.1簽名方法示例說明

3.3.2        返回

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

參數(shù)	參數(shù)名稱	數(shù)據(jù)類型	參數(shù)說明	是否可空
基本參數(shù)
version	版本號	String(4)	網(wǎng)關(guān)版本號，此版本為1.2	不可空
charset	編碼字符集	String(10)	如：gbk，gb2312，utf-8，Shift-JIS	不可空
language	語言	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	商戶訂單號	String(64)	合作商戶網(wǎng)站唯一訂單號，請確保在商戶系統(tǒng)中唯一	不可空
masapayOrderNo	交易流水號	String(16)	MasaPay系統(tǒng)交易流水號	不可空
submitTime	提交時(shí)間	String(14)	商戶提交訂單的時(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 國際信用卡	不可空
orgCode	付款機(jī)構(gòu)代碼	String(10)	國際信用卡：VISA，MASTER，JCB，AME，DINERSCLUB	可空
resultCode	處理結(jié)果	String(2)	00 已受理10 支付成功 11支付失敗	不可空
riskLevel	風(fēng)險(xiǎn)等級	String(2)	00無風(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)	回傳原訂單商戶提交的ext1	可空
ext2	擴(kuò)展字段	String(256)	回傳原訂單商戶提交的ext2	可空
signMsg	簽名字符串	String(256)	參見簽名元素說明	不可空

參與簽名元素說明：
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}
簽名方法示例說明：
詳情參考附錄8.1簽名方法示例說明
 

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

4.1   功能概要

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

4.2   通知商戶接口

4.2.1        回調(diào)商戶URL

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

參數(shù)	參數(shù)名稱	數(shù)據(jù)類型		參數(shù)說明	是否可空
基本參數(shù)
version	版本號	String(4)		網(wǎng)關(guān)版本號，此版本為1.2	不可空
charset	編碼字符集	String(10)		如：gbk，gb2312，utf-8，Shift-JIS	不可空
language	語言	String(2)		cn中文 en 英文 ru俄文 jp日文	不可空
signType	簽名方式	String(8)		SHA256，MD5可選	不可空
業(yè)務(wù)參數(shù)
merchantOrderNo	商戶訂單號	String(64)		合作商戶網(wǎng)站唯一訂單號，請確保在商戶系統(tǒng)中唯一	不可空
masapayOrderNo	交易流水號	String(16)		MasaPay系統(tǒng)交易流水號	不可空
submitTime	提交時(shí)間	String(14)		商戶提交訂單的時(shí)間，年月日時(shí)分秒 如：20121117020101	不可空
dealTime	交易完成時(shí)間	String(14)		MasaPay交易完成時(shí)間，年月日時(shí)分秒，如：20121117020101	不可空
currencyCode	幣種	String(3)	CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門元, MYR馬來西亞, 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 國際信用卡 20 本地第三方支付 30 線下匯款 90 銀聯(lián)支付	不可空
orgCode	付款機(jī)構(gòu)代碼	String(10)		直連必填 國際信用卡：VISA，MASTER，JCB，AME，DINERSCLUB 本地第三方支付：WEBMONEY，QIWI，WALLETONE，PAYON 線下匯款：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)等級	String(2)		00無風(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)		回傳原訂單商戶提交的ext1	可空
ext2	擴(kuò)展字段	String(256)		回傳原訂單商戶提交的ext2	可空
signMsg	簽名字符串	String(256)		參見簽名元素說明	不可空

參與簽名元素說明：
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}
簽名方法示例說明：
詳情參考附錄8.1簽名方法示例說明

4.2.2        商戶應(yīng)答

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

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

 
 

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

5.1   功能概要

商戶查詢接口實(shí)現(xiàn)：在商戶網(wǎng)站查詢在MasaPay某段時(shí)間的交易記錄或某筆交易記錄。

5.2   系統(tǒng)交互

5.3   商戶查詢接口

5.3.1        請求

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

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

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

5.3.2        返回

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

參數(shù)	參數(shù)名稱	數(shù)據(jù)類型	參數(shù)說明		是否可空
基本參數(shù)
version	版本號	String(4)	網(wǎng)關(guān)版本號，此版本為1.2		不可空
merchantId	商戶號	String(32)	商戶開戶時(shí)由MasaPay分配		不可空
charset	編碼字符集	String(10)	如：gbk，gb2312，utf-8，Shift-JIS		不可空
language	語言	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)	參見簽名元素說明		不可空
訂單信息(list)
merchantOrderNo	商戶訂單號	String(60)	商戶系統(tǒng)唯一訂單號		不可空
masapayOrderNo	交易流水號	String(16)	MasaPay系統(tǒng)交易流水號		不可空
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 國際信用卡 20 本地第三方支付 30 線下匯款 90 銀聯(lián)支付		可空
orgCode	付款機(jī)構(gòu)代碼	String(10)	國際信用卡：VISA，MASTER，JCB，AME，DINERSCLUB 本地第三方支付：WEBMONEY，QIWI，WALLETONE，PAYON 線下匯款：WESTERNUNION , MONEYGRAM 銀聯(lián)支付：UPOP		可空
paidAmount	實(shí)際支付金額	String(18)	整型數(shù)字 除了日元、韓元為元，其他幣種為分		不可空
currencyCode	幣種	String(3)	CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門元, MYR馬來西亞, NZD新西蘭元, CHF瑞士法郎, THB泰銖, TWD新臺(tái)幣, KRW韓元, INR印度盧比, CAD加元, AUD澳元, HKD港幣, GBP英鎊, EUR歐元	不可空
payCurrencyCode	支付幣種	String(3)	CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門元, MYR馬來西亞, 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)等級	String(2)	00無風(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)	訂單記錄的加密元素		不可空

參與簽名元素說明：
signMsg=SHA256(version=1.2&merchantId=88800033122&charset=utf-8&language=en&signType=SHA256& recordCount=1&key={key}
OrdersignMsg簽名元素說明：
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}
簽名方法示例說明：
詳情參考附錄8.1簽名方法示例說明
 

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

6.1   功能概要

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

6.2   系統(tǒng)交互

6.3   商戶退款接口

6.3.1        請求

參數(shù)	參數(shù)名稱	數(shù)據(jù)類型	參數(shù)說明	是否可空
基本參數(shù)
version	版本號	String(4)	網(wǎng)關(guān)版本號，此版本為1.2	不可空
merchantId	商戶號	String(32)	商戶開戶時(shí)由MasaPay分配	不可空
charset	編碼字符集	String(10)	如gbk，gb2312，utf-8，Shift-JIS	不可空
language	語言	String(2)	cn中文 en 英文 ru俄文 jp日文	不可空
signType	簽名方式	String(8)	SHA256，MD5可選	不可空
業(yè)務(wù)參數(shù)
refundOrderNo	退款訂單號	String(30)	商戶生成的唯一退款流水號	不可空
merchantOrderNo	原商戶訂單號	String(64)	原商戶支付訂單號	不可空
masapayOrderNo	原MasaPay交易流水號	String(16)	原MasaPay交易流水號	可空
refundAmount	退款金額	String(18)	整型數(shù)字 除了日元、韓元為元，其他幣種為分	不可空
currencyCode	幣種	String(3)	CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門元, MYR馬來西亞, 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)	通知商戶退款訂單結(jié)果的回調(diào)地址	不可空
signMsg	簽名字符串	String(256)	參見簽名元素說明	不可空

參與簽名元素說明：
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}
簽名方法示例說明：
詳情參考附錄8.1簽名方法示例說明

6.3.2        返回

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

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

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

6.4   退款通知接口

6.4.1        通知

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

參數(shù)	參數(shù)名稱	數(shù)據(jù)類型	參數(shù)說明	是否可空
基本參數(shù)
version	版本號	String(4)	網(wǎng)關(guān)版本號，此版本為1.2	不可空
charset	編碼字符集	String(10)	如：gbk，gb2312，utf-8，Shift-JIS	不可空
language	語言	String(2)	cn中文 en 英文 ru俄文 jp日文	不可空
signType	簽名方式	String(8)	SHA256，MD5可選	不可空
業(yè)務(wù)參數(shù)
refundOrderNo	退款訂單號	String(64)	合作商戶網(wǎng)站唯一退款號,確保在商戶系統(tǒng)中唯一	不可空
merchantOrderNo	原商戶訂單號	String(64)	原商戶訂單號	不可空
masapayOrderNo	原MasaPay交易流水號	String(16)	原MasaPay交易流水號	可空
masapayRefundOrderNo	Masapay退款流水號	String(16)	Masapay退款流水號	不可空
submitTime	提交時(shí)間	String(14)	商戶提交退款訂單的時(shí)間，年月日時(shí)分秒如：20121117020101	不可空
dealTime	交易完成時(shí)間	String(14)	MasaPay退款交易完成時(shí)間，年月日時(shí)分秒如：20121117020101	不可空
currencyCode	幣種	String(3)	CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門元, MYR馬來西亞, 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)	參見簽名元素說明	不可空

參與簽名元素說明：
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}
簽名方法示例說明：
詳情參考附錄8.1簽名方法示例說明

6.4.2        應(yīng)答

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

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

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

7.1   功能概要

在商戶自己的網(wǎng)站查詢在MasaPay某段時(shí)間的交易記錄或某筆交易記錄。

7.2   系統(tǒng)交互

7.3   退款查詢接口

7.3.1        請求

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

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

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

7.3.2        返回

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

參數(shù)	參數(shù)名稱	數(shù)據(jù)類型	參數(shù)說明		是否可空
基本參數(shù)
version	版本號	String(4)	網(wǎng)關(guān)版本號，此版本為1.2		不可空
merchantId	商戶號	String(32)	商戶開戶時(shí)由MasaPay分配		不可空
charset	編碼字符集	String(10)	如：gbk，gb2312，utf-8，Shift-JIS		不可空
language	語言	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)	參見簽名元素說明		不可空
訂單信息(list)
refundOrderNo	退款訂單號	String(30)	商戶生成的唯一退款流水號		不可空
merchantOrderNo	原商戶訂單號	String(64)	原商戶訂單號		不可空
masapayRefundOrderNo	退款流水號	String(16)	MasaPay系統(tǒng)退款流水號		不可空
refundAmount	實(shí)際退款金額	String(18)	整型數(shù)字 除了日元、韓元為元，其他幣種為分		不可空
currencyCode	幣種	String(3)	CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門元, MYR馬來西亞, 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參與簽名元素元素說明：
version=1.2&merchantId=88800033122&charset=utf-8&language=en&signType=SHA256&recordCount=1&key={key}
OrdersignMsg參與簽名元素說明：
refundOrderNo=0001&merchantOrderNo=10000121&masapayRefundOrderNo1111111111111111&refundAmount=100&currencyCode=CNY&submitTime=20121117020101&dealTime=20121117020101&status=P&key={key}
簽名方法示例說明：
詳情參考附錄8.1簽名方法示例說明
 

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

8.1   功能概要

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

8.2   快遞單上傳接口

8.2.1        請求

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

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

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

8.2.2        返回

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

參數(shù)		參數(shù)名稱	數(shù)據(jù)類型		參數(shù)說明			是否可空
基本參數(shù)
version		版本號	String(4)		網(wǎng)關(guān)版本號，此版本為1.2			不可空
merchantId		商戶號	String(32)		商戶開戶時(shí)由MasaPay分配			不可空
charset		編碼字符集	String(10)		如：gbk，gb2312，utf-8，Shift-JIS			不可空
language		語言	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)		參見簽名元素說明			不可空
未成功快遞單信息list
merchantOrderNo	商戶訂單號			String(64)		原商戶支付訂單號			不可空
expressDate	配送時(shí)間			String(14)		年月日時(shí)分秒如：20121117020101			不可空
etaDate	預(yù)計(jì)妥投時(shí)間			String(14)		年月日時(shí)分秒如：20121117020101			不可空
expressNo	快遞單號			String(32)		快遞公司下單時(shí)訂單號			不可空
expressCompany	快遞公司			String(60)		快遞公司名稱			不可空
expressUrl	查單網(wǎng)址			String(200)		快遞公司查詢訂單網(wǎng)址			不可空
uploadDate	上傳時(shí)間			String(14)		年月日時(shí)分秒如：20121117020101			不可空
expressSignMsg		單筆快遞單簽名字符串	String(256)		每筆快遞單記錄的簽名字符串					不可空

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

9     附錄

9.1   簽名方法示例說明

9.1.1        商戶提交訂單接口

簽名算法：
SHA256
參與簽名元素：
version=1.2&merchantId=88800033122&charset=utf-8&language=en&signType=SHA256&merchantOrderNo=10000121&goodsName=女士服裝&goodsDesc=商品名稱1^商品規(guī)格1^購買數(shù)量1^商品單價(jià)1^商品展示網(wǎng)址1|商品名稱2^商品規(guī)格2^購買數(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對上述簽名元素得出的簽名結(jié)果（二進(jìn)制轉(zhuǎn)十六進(jìn)制大寫）如下：
AD59678D5389974AB6886A3AAB6133FE0BCF1C0BA56E270B71C941F135F00BC0
提交參數(shù)示例：
version=1.2&merchantId=88800033122&charset=utf-8&language=en&signType=SHA256&merchantOrderNo=10000121&goodsName=女士服裝&goodsDesc=商品名稱1^商品規(guī)格1^購買數(shù)量1^商品單價(jià)1^商品展示網(wǎng)址1|商品名稱2^商品規(guī)格2^購買數(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        通知商戶接口

簽名算法：
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對上述簽名元素得出的簽名結(jié)果（二進(jìn)制轉(zhuǎn)十六進(jìn)制大寫）如下：
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)系郵箱：[email protected]
聯(lián)系電話：+86+21-61001361
 

9.3   約定

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

世聯(lián)翻譯-讓世界自由溝通！專業(yè)的全球語言翻譯供應(yīng)商，上海翻譯公司專業(yè)品牌。絲路沿線56種語言一站式翻譯與技術(shù)解決方案，專業(yè)英語翻譯、日語翻譯等文檔翻譯、同傳口譯、視頻翻譯、出國外派服務(wù)，加速您的全球交付。 世聯(lián)翻譯公司在北京、上海、深圳等國際交往城市設(shè)有翻譯基地，業(yè)務(wù)覆蓋全國城市。每天有近百萬字節(jié)的信息和貿(mào)易通過世聯(lián)走向全球！積累了大量政商用戶數(shù)據(jù)，翻譯人才庫數(shù)據(jù)，多語種語料庫大數(shù)據(jù)。世聯(lián)品牌和服務(wù)品質(zhì)已得到政務(wù)防務(wù)和國際組織、跨國公司和大中型企業(yè)等近萬用戶的認(rèn)可。