版本	更改日期	作者	版本變化
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收單版本升級為1.1 2.4   頁(yè)面回調新增errCode、errMsg 4.2通知商戶(hù)接口新增errCode、errMsg
2.0	2013-08-21	周穎	網(wǎng)關(guān)版本升級為1.2 2.3   商戶(hù)提交訂單接口修改內容：     新增賬單地址、收貨地址 3.3   商戶(hù)訂單支付接口修改內容： 支付ip改為非空 支付郵箱改為非空 持卡人郵箱改為非空 收貨國家、收貨州/城市改為非空 姓名改成姓、名及加簽字段 新增設備指紋deviceFingerprintID及加簽
2.0	2013/9/5	周穎	下單IP改為非空
2.1	2013/10/22	周穎	新增8.api 快遞單上傳接口
2.2	2013/10/31	周穎	根據運營(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)站標價(jià)使用乾匯支持的幣種，付款者付款用貨幣類(lèi)型為相關(guān)支付方式支持的幣種。

1.2   閱讀對象

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

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

2.1   功能概要

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

2.2   系統交互

圖2.1系統交互圖

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

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

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

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

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

備注：
最終支付結果請以通知為準。

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

3.1   功能概要

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

3.2   系統交互

圖3.1系統交互圖

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

3.3.1        請求

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

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

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

4.1   功能概要

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

4.2   通知商戶(hù)接口

4.2.1        回調商戶(hù)URL

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

參數	參數名稱(chēng)	數據類(lèi)型		參數說(shuō)明	是否可空
基本參數
version	版本號	String(4)		網(wǎng)關(guān)版本號，此版本為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ù)參數
merchantOrderNo	商戶(hù)訂單號	String(64)		合作商戶(hù)網(wǎng)站唯一訂單號，請確保在商戶(hù)系統中唯一	不可空
masapayOrderNo	交易流水號	String(16)		MasaPay系統交易流水號	不可空
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新臺幣, KRW韓元, INR印度盧比, CAD加元, AUD澳元, HKD港幣, GBP英鎊, EUR歐元		不可空
orderAmount	訂單金額	String(18)	整型數字 除了日元、韓元為元，其他幣種為分		不可空
payCurrencyCode	支付幣種	String(3)		CNY人民幣USD美元EUR歐元RUB盧布JPY日元	不可空
rates	匯率	String(20)		精確到小數點(diǎn)后5位	不可空
paidAmount	實(shí)際支付金額	String(18)		整型數字 除了日元、韓元為元，其他幣種為分	不可空
payMode	支付方式	String(2)		直連必填 10 國際信用卡 20 本地第三方支付 30 線(xiàn)下匯款 90 銀聯(lián)支付	不可空
orgCode	付款機構代碼	String(10)		直連必填 國際信用卡：VISA，MASTER，JCB，AME，DINERSCLUB 本地第三方支付：WEBMONEY，QIWI，WALLETONE，PAYON 線(xiàn)下匯款：WESTERNUNION , MONEYGRAM 銀聯(lián)支付：UPOP	可空
resultCode	處理結果	String(2)		10 支付成功 11支付失敗 12 DM審核中	不可空
errCode	錯誤代碼	String(10)		失敗時(shí)返回的錯誤代碼	可空
errMsg	錯誤信息	String(256)		失敗時(shí)返回的錯誤信息	可空
riskLevel	風(fēng)險等級	String(2)		00無(wú)風(fēng)險，01風(fēng)控拒絕，02可疑 03交易滯留	可空
riskOccurCount	風(fēng)險訂單累計數量	String(4)		風(fēng)險訂單累計數量	可空
riskDesc	風(fēng)險描述	String(256)		風(fēng)險備注	可空
ext1	擴展字段	String(256)		回傳原訂單商戶(hù)提交的ext1	可空
ext2	擴展字段	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ù)應答

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

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

 
 

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

5.1   功能概要

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

5.2   系統交互

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

5.3.1        請求

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

參數	參數名稱(chēng)	數據類(lèi)型	參數說(shuō)明	是否可空
基本參數
version	版本號	String(4)	網(wǎng)關(guān)版本號，此版本為1.2	不可空
merchantId	商戶(hù)號	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ù)參數
queryType	查詢(xún)方式	String(1)	0按MasaPay系統交易流水號單筆查詢(xún) 1 按商戶(hù)訂單號查詢(xún) 2按交易結束時(shí)間批量查詢(xún),只返回成功訂單	不可空
masapayOrderNo	交易流水號	String(16)	查詢(xún)方式為0時(shí)必填	可空
merchantOrderNo	商戶(hù)訂單號	String(64)	查詢(xún)方式為1時(shí)必填	可空
startTime	訂單提交開(kāi)始時(shí)間	String(14)	查詢(xún)方式為2時(shí)必填 年月日時(shí)分秒如：20121117020101	可空
endTime	訂單提交結束時(shí)間	String(14)	查詢(xún)方式為2時(shí)必填 年月日時(shí)分秒如：20121117020101限制時(shí)間段14天內，跨度24小時(shí)	可空
signMsg	簽名字符串	String(256)	參見(jiàn)簽名元素說(shuō)明	不可空

備注：
如果商戶(hù)指定了重復提交，根據商戶(hù)訂單號查詢(xún)將可能會(huì )返回多條結果。
參與簽名元素說(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 格式將數據返回給商戶(hù)。

參數	參數名稱(chēng)	數據類(lèi)型	參數說(shuō)明		是否可空
基本參數
version	版本號	String(4)	網(wǎng)關(guān)版本號，此版本為1.2		不可空
merchantId	商戶(hù)號	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	錯誤代碼	String(10)	失敗時(shí)返回的錯誤代碼		可空
errMsg	錯誤信息	String(256)	失敗時(shí)返回的錯誤信息		可空
recordCount	記錄集總條數	String(10)	記錄集總條數		不可空
signMsg	簽名字符串	String(256)	參見(jiàn)簽名元素說(shuō)明		不可空
訂單信息(list)
merchantOrderNo	商戶(hù)訂單號	String(60)	商戶(hù)系統唯一訂單號		不可空
masapayOrderNo	交易流水號	String(16)	MasaPay系統交易流水號		不可空
orderAmount	訂單金額	String(18)	整型數字 除了日元、韓元為元，其他幣種為分		不可空
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 線(xiàn)下匯款 90 銀聯(lián)支付		可空
orgCode	付款機構代碼	String(10)	國際信用卡：VISA，MASTER，JCB，AME，DINERSCLUB 本地第三方支付：WEBMONEY，QIWI，WALLETONE，PAYON 線(xiàn)下匯款：WESTERNUNION , MONEYGRAM 銀聯(lián)支付：UPOP		可空
paidAmount	實(shí)際支付金額	String(18)	整型數字 除了日元、韓元為元，其他幣種為分		不可空
currencyCode	幣種	String(3)	CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門(mén)元, MYR馬來(lái)西亞, NZD新西蘭元, CHF瑞士法郎, THB泰銖, TWD新臺幣, 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新臺幣, KRW韓元, INR印度盧比, CAD加元, AUD澳元, HKD港幣, GBP英鎊, EUR歐元		不可空
rates	匯率	String(20)	精確到小數點(diǎn)后5位		不可空
riskLevel	風(fēng)險等級	String(2)	00無(wú)風(fēng)險，01風(fēng)控拒絕，02可疑 03交易滯留		可空
riskOccurCount	風(fēng)險訂單累計數量	String(4)	風(fēng)險訂單累計數量		可空
riskDesc	風(fēng)險描述	String(256)	風(fēng)險備注		可空
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ù)將購買(mǎi)產(chǎn)品或服務(wù)的款項全部或部分退還給用戶(hù)
商戶(hù)退款通知接口：在退款成功后，通知商戶(hù)系統退款成功。

6.2   系統交互

6.3   商戶(hù)退款接口

6.3.1        請求

參數	參數名稱(chēng)	數據類(lèi)型	參數說(shuō)明	是否可空
基本參數
version	版本號	String(4)	網(wǎng)關(guān)版本號，此版本為1.2	不可空
merchantId	商戶(hù)號	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ù)參數
refundOrderNo	退款訂單號	String(30)	商戶(hù)生成的唯一退款流水號	不可空
merchantOrderNo	原商戶(hù)訂單號	String(64)	原商戶(hù)支付訂單號	不可空
masapayOrderNo	原MasaPay交易流水號	String(16)	原MasaPay交易流水號	可空
refundAmount	退款金額	String(18)	整型數字 除了日元、韓元為元，其他幣種為分	不可空
currencyCode	幣種	String(3)	CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門(mén)元, MYR馬來(lái)西亞, NZD新西蘭元, CHF瑞士法郎, THB泰銖, TWD新臺幣, KRW韓元, INR印度盧比, CAD加元, AUD澳元, HKD港幣, GBP英鎊, EUR歐元	不可空
refundSubmitTime	退款提交時(shí)間	String(14)	年月日時(shí)分秒 如：20121117020101	不可空
callbackUrl	回調通知URL	String(256)	通知商戶(hù)退款訂單結果的回調地址	不可空
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 格式將數據返回給商戶(hù)。

參數	參數名稱(chēng)	數據類(lèi)型	參數說(shuō)明	是否可空
基本參數
version	版本號	String(4)	網(wǎng)關(guān)版本號，此版本為1.2	不可空
merchantId	商戶(hù)號	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ù)參數
resultCode	退款結果	String(2)	10表示退款申請成功 11表示退款申請失敗	不可空
errorMsg	錯誤信息	String(256)	失敗時(shí)返回的錯誤信息	可空
refundOrderNo	退款訂單號	String(32)	與提交時(shí)退款流水號保持一致	不可空

參與簽名元素說(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)收單子系統
接收方：商戶(hù)系統
通知地址：商戶(hù)退款時(shí)提供的noticeUrl + POST請求
參數：

參數	參數名稱(chēng)	數據類(lèi)型	參數說(shuō)明	是否可空
基本參數
version	版本號	String(4)	網(wǎng)關(guān)版本號，此版本為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ù)參數
refundOrderNo	退款訂單號	String(64)	合作商戶(hù)網(wǎng)站唯一退款號,確保在商戶(hù)系統中唯一	不可空
merchantOrderNo	原商戶(hù)訂單號	String(64)	原商戶(hù)訂單號	不可空
masapayOrderNo	原MasaPay交易流水號	String(16)	原MasaPay交易流水號	可空
masapayRefundOrderNo	Masapay退款流水號	String(16)	Masapay退款流水號	不可空
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新臺幣, KRW韓元, INR印度盧比, CAD加元, AUD澳元, HKD港幣, GBP英鎊, EUR歐元	不可空
refundAmount	退款金額	String(18)	整型數字 除了日元、韓元為元，其他幣種為分	不可空
resultCode	處理結果	String(2)	10 退款成功 11退款失敗	不可空
ext1	擴展1	String(256)	擴展字段	可空
ext2	擴展2	String(256)	擴展字段	可空
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        應答

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

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

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

7.1   功能概要

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

7.2   系統交互

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

7.3.1        請求

發(fā)起方：商戶(hù)系統
接收方：MasaPay互聯(lián)網(wǎng)收單系統
生產(chǎn)提交地址：
測試提交地址：
輸入參數：

參數	參數名稱(chēng)	數據類(lèi)型	參數說(shuō)明	是否可空
基本參數
version	版本號	String(4)	網(wǎng)關(guān)版本號，此版本為1.2	不可空
merchantId	商戶(hù)號	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ù)參數
queryType	查詢(xún)方式	String(1)	0 按商戶(hù)訂單號單筆查詢(xún) 1 按交易結束時(shí)間批量查詢(xún)，只返回成功訂單	不可空
refundOrderNo	退款訂單號	String(30)	查詢(xún)方式為0時(shí)必填，商戶(hù)生成的唯一退款流水號	不可空
startTime	退款提交起始時(shí)間	String(14)	查詢(xún)方式為1時(shí)必填，年月日時(shí)分秒如：20121117020101	可空
endTime	退款提交結束時(shí)間	String(14)	查詢(xún)方式為1時(shí)必填，年月日時(shí)分秒如：20121117020101限制查詢(xún)時(shí)間段14天內，跨度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 格式將數據返回給商戶(hù)。

參數	參數名稱(chēng)	數據類(lèi)型	參數說(shuō)明		是否可空
基本參數
version	版本號	String(4)	網(wǎng)關(guān)版本號，此版本為1.2		不可空
merchantId	商戶(hù)號	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	錯誤代碼	String(10)	失敗時(shí)返回的錯誤代碼		可空
errMsg	錯誤信息	String(256)	失敗時(shí)返回的錯誤信息		可空
recordCount	記錄集總條數	String(10)			不可空
signMsg	簽名字符串	String(256)	參見(jiàn)簽名元素說(shuō)明		不可空
訂單信息(list)
refundOrderNo	退款訂單號	String(30)	商戶(hù)生成的唯一退款流水號		不可空
merchantOrderNo	原商戶(hù)訂單號	String(64)	原商戶(hù)訂單號		不可空
masapayRefundOrderNo	退款流水號	String(16)	MasaPay系統退款流水號		不可空
refundAmount	實(shí)際退款金額	String(18)	整型數字 除了日元、韓元為元，其他幣種為分		不可空
currencyCode	幣種	String(3)	CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門(mén)元, MYR馬來(lái)西亞, NZD新西蘭元, CHF瑞士法郎, THB泰銖, TWD新臺幣, 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í)現：商戶(hù)上傳快遞單數據。

8.2   快遞單上傳接口

8.2.1        請求

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

參數	參數名稱(chēng)			數據類(lèi)型			參數說(shuō)明	是否可空
基本參數
version	版本號		String(4)		網(wǎng)關(guān)版本號，此版本為1.2			不可空
merchantId	商戶(hù)號		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	快遞單總數		String(10)		上傳快遞單總數量			不可空
signType	簽名方式		String(8)		SHA256，MD5可選			不可空
signMsg	簽名字符串			String(256)			參見(jiàn)簽名元素說(shuō)明	不可空
快遞單信息list
merchantOrderNo	商戶(hù)訂單號			String(64)			原商戶(hù)支付訂單號	不可空
expressDate	配送時(shí)間			String(14)			年月日時(shí)分秒如：20121117020101	不可空
etaDate	預計妥投時(shí)間			String(14)			年月日時(shí)分秒如：20121117020101	不可空
expressNo	快遞單號			String(32)			快遞公司下單時(shí)訂單號	不可空
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 格式將數據返回給商戶(hù)。

參數		參數名稱(chēng)	數據類(lèi)型		參數說(shuō)明			是否可空
基本參數
version		版本號	String(4)		網(wǎng)關(guān)版本號，此版本為1.2			不可空
merchantId		商戶(hù)號	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		錯誤代碼	String(10)		失敗時(shí)返回的錯誤代碼			可空
errMsg		錯誤信息	String(256)		失敗時(shí)返回的錯誤信息			可空
expressCount	快遞單總數		String(10)		成功收到快遞單總數量		不可空
signMsg		簽名字符串	String(256)		參見(jiàn)簽名元素說(shuō)明			不可空
未成功快遞單信息list
merchantOrderNo	商戶(hù)訂單號			String(64)		原商戶(hù)支付訂單號			不可空
expressDate	配送時(shí)間			String(14)		年月日時(shí)分秒如：20121117020101			不可空
etaDate	預計妥投時(shí)間			String(14)		年月日時(shí)分秒如：20121117020101			不可空
expressNo	快遞單號			String(32)		快遞公司下單時(shí)訂單號			不可空
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^商品規格1^購買(mǎi)數量1^商品單價(jià)1^商品展示網(wǎng)址1|商品名稱(chēng)2^商品規格2^購買(mǎi)數量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對上述簽名元素得出的簽名結果（二進(jìn)制轉十六進(jìn)制大寫(xiě)）如下：
AD59678D5389974AB6886A3AAB6133FE0BCF1C0BA56E270B71C941F135F00BC0
提交參數示例：
version=1.2&merchantId=88800033122&charset=utf-8&language=en&signType=SHA256&merchantOrderNo=10000121&goodsName=女士服裝&goodsDesc=商品名稱(chēng)1^商品規格1^購買(mǎi)數量1^商品單價(jià)1^商品展示網(wǎng)址1|商品名稱(chēng)2^商品規格2^購買(mǎi)數量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對上述簽名元素得出的簽名結果（二進(jìn)制轉十六進(jìn)制大寫(xiě)）如下：
AE403619EA1D5F460F1F4819802AF9F647C3A4169BACF3F35ECF081568EC2B94
提交參數示例：
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)調人員：周穎
聯(lián)系郵箱：zhouying@masapay.com
聯(lián)系電話(huà)：+86+21-61001361
 

9.3   約定

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

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