上海翻譯公司完成銀行系統(tǒng)中文翻譯
|
版本 |
更改日期 |
作者 |
版本變化 |
|
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)價使用乾匯支持的幣種，付款者付款用貨幣類型為相關(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 功能概要
商戶提交訂單接口實現(xiàn)：商戶向MasaPay互聯(lián)網(wǎng)收單系統(tǒng)提交訂單信息和明細(xì)信息。
通知商戶接口實現(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) |
商戶開戶時由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^商品單價1^商品展示網(wǎng)址1|商品名稱2^商品規(guī)格2^購買數(shù)量2^商品單價2^商品展示網(wǎng)址2|…… |
不可空 |
|
|
currencyCode |
幣種 |
String(3) |
CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門元, MYR馬來西亞, NZD新西蘭元, CHF瑞士法郎, THB泰銖, TWD新臺幣, 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 |
是否做收款人信息驗證 |
String(1) |
Y驗證N不驗證，默認(rèn)不驗證 |
可空 |
|
|
directFlag |
是否直連 |
String(1) |
N非直連D直連E內(nèi)嵌 |
不可空 |
|
|
allowDuplicate |
是否可重復(fù)支付 |
String(1) |
Y允許N不允許，默認(rèn)不允許 |
可空 |
|
|
submitTime |
提交時間 |
String(14) |
年月日時分秒
如：20121117020101 |
不可空 |
|
|
expiryTime |
失效時間 |
String(14) |
年月日時分秒
如：20121117020101 |
可空 |
|
|
pageUrl |
前臺回調(diào)URL |
String(256) |
用于在用戶支付完成后跳轉(zhuǎn)回商戶指定的URL |
不可空 |
|
|
bgUrl |
通知URL |
String(256) |
通知商戶訂單支付結(jié)果的地址 |
不可空 |
|
|
ext1 |
擴(kuò)展字段 |
String(256) |
通知商戶訂單支付處理結(jié)果時回傳該參數(shù)。不能包含=，&等特殊字符 |
可空 |
|
|
ext2 |
擴(kuò)展字段 |
String(256) |
通知商戶訂單支付處理結(jié)果時回傳該參數(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 |
注冊時間 |
String(14) |
年月日時分秒
如：20121117020101 |
不可空 |
|
|
registerIp |
注冊IP |
String(20) |
如：[202.96.209.16] |
不可空 |
|
|
registerTerminal |
注冊終端設(shè)備 |
String(20) |
00 PC 01手機(jī) 02其他 |
不可空 |
|
|
orderIp |
下單IP |
String(20) |
付款人下單時IP地址
如：[202.96.209.16] |
不可空 |
|
|
orderTerminal |
終端設(shè)備 |
String(20) |
付款人下單時終端設(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^商品單價1^商品展示網(wǎng)址1|商品名稱2^商品規(guī)格2^購買數(shù)量2^商品單價2^商品展示網(wǎng)址2¤cyCode=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)
通知地址：商戶下單時提供的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新臺幣, KRW韓元, INR印度盧比, CAD加元, AUD澳元, HKD港幣, GBP英鎊, EUR歐元 |
不可空 |
|
orderAmount |
訂單金額 |
String(18) |
單位元 |
不可空 |
|
payCurrencyCode |
支付幣種 |
String(3) |
CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門元, MYR馬來西亞, NZD新西蘭元, CHF瑞士法郎, THB泰銖, TWD新臺幣, KRW韓元, INR印度盧比, CAD加元, AUD澳元, HKD港幣, GBP英鎊, EUR歐元 |
不可空 |
|
payAmount |
支付金額 |
String(18) |
單位元 |
不可空 |
|
rates |
匯率 |
String(20) |
精確到小數(shù)點后5位 |
不可空 |
|
resultCode |
處理結(jié)果 |
String(4) |
10 支付成功 11支付失敗12支付中 |
不可空 |
|
errCode |
錯誤代碼 |
String(10) |
失敗時返回的錯誤代碼 |
可空 |
|
errMsg |
錯誤信息 |
String(256) |
失敗時返回的錯誤信息 |
可空 |
|
signMsg |
簽名字符串 |
String(256) |
參見簽名元素說明 |
不可空 |
備注：
最終支付結(jié)果請以通知為準(zhǔn)。
3 API收款業(yè)務(wù)
3.1 功能概要
商戶提交訂單接口實現(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) |
商戶開戶時由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^商品單價1^商品展示網(wǎng)址1|商品名稱2^商品規(guī)格2^購買數(shù)量2^商品單價2^商品展示網(wǎng)址2|…… |
不可空 |
|
currencyCode |
幣種 |
String(3) |
CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門元, MYR馬來西亞, NZD新西蘭元, CHF瑞士法郎, THB泰銖, TWD新臺幣, KRW韓元, INR印度盧比, CAD加元, AUD澳元, HKD港幣, GBP英鎊, EUR歐元 |
不可空 |
|
orderAmount |
訂單金額 |
String(18) |
整型數(shù)字
除了日元、韓元為元，其他幣種為分 |
不可空 |
|
payerAuth |
是否做收款人信息驗證 |
String(1) |
Y驗證N不驗證，默認(rèn)不驗證 |
可空 |
|
allowDuplicate |
是否可重復(fù)支付 |
String(1) |
Y允許N不允許，默認(rèn)不允許 |
可空 |
|
submitTime |
提交時間 |
String(14) |
年月日時分秒
如：20121117020101 |
不可空 |
|
expiryTime |
失效時間 |
String(14) |
年月日時分秒
如：20121117020101 |
可空 |
|
bgUrl |
通知URL |
String(256) |
通知商戶訂單支付結(jié)果的地址 |
不可空 |
|
ext1 |
擴(kuò)展字段 |
String(256) |
通知商戶訂單支付處理結(jié)果時回傳該參數(shù)。不能包含=，&等特殊字符 |
可空 |
|
ext2 |
擴(kuò)展字段 |
String(256) |
通知商戶訂單支付處理結(jié)果時回傳該參數(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 |
注冊時間 |
String(14) |
年月日時分秒
如：20121117020101 |
不可空 |
|
registerIp |
注冊IP |
String(20) |
如：[202.96.209.16] |
不可空 |
|
registerTerminal |
注冊終端設(shè)備 |
String(20) |
00 PC 01手機(jī) 02其他 |
不可空 |
|
orderIp |
下單IP |
String(20) |
付款人下單時IP地址
如：[202.96.209.16] |
不可空 |
|
orderTerminal |
終端設(shè)備 |
String(2) |
付款人下單時終端設(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^商品單價1^商品展示網(wǎng)址1|商品名稱2^商品規(guī)格2^購買數(shù)量2^商品單價2^商品展示網(wǎng)址2¤cyCode=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 |
錯誤代碼 |
String(10) |
失敗時返回的錯誤代碼 |
可空 |
|
errMsg |
錯誤信息 |
String(256) |
失敗時返回的錯誤信息 |
可空 |
|
signType |
簽名方式 |
String(8) |
SHA256，MD5可選 |
不可空 |
|
業(yè)務(wù)參數(shù) |
|
merchantOrderNo |
商戶訂單號 |
String(64) |
合作商戶網(wǎng)站唯一訂單號，請確保在商戶系統(tǒng)中唯一 |
不可空 |
|
masapayOrderNo |
交易流水號 |
String(16) |
MasaPay系統(tǒng)交易流水號 |
不可空 |
|
submitTime |
提交時間 |
String(14) |
商戶提交訂單的時間，年月日時分秒
如：20121117020101 |
不可空 |
|
dealTime |
交易完成時間 |
String(14) |
MasaPay交易完成時間，年月日時分秒，如：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ù)點后5位 |
不可空 |
|
paidAmount |
實際支付金額 |
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)險等級 |
String(2) |
00無風(fēng)險，01風(fēng)控拒絕，02可疑
03交易滯留 |
可空 |
|
riskOccurCount |
風(fēng)險訂單累計數(shù)量 |
String(4) |
風(fēng)險訂單累計數(shù)量 |
可空 |
|
riskDesc |
風(fēng)險描述 |
String(256) |
風(fēng)險備注 |
可空 |
|
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¤cyCode=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 功能概要
通知商戶接口實現(xiàn)：在交易支付成功后，通知商戶系統(tǒng)訂單支付成功。
4.2 通知商戶接口
4.2.1 回調(diào)商戶URL
發(fā)起方：互聯(lián)網(wǎng)收單子系統(tǒng)
接收方：商戶系統(tǒng)
通知地址：商戶下單時提供的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 |
提交時間 |
String(14) |
商戶提交訂單的時間，年月日時分秒
如：20121117020101 |
不可空 |
|
dealTime |
交易完成時間 |
String(14) |
MasaPay交易完成時間，年月日時分秒，如：20121117020101 |
不可空 |
|
currencyCode |
幣種 |
String(3) |
CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門元, MYR馬來西亞, NZD新西蘭元, CHF瑞士法郎, THB泰銖, TWD新臺幣, KRW韓元, INR印度盧比, CAD加元, AUD澳元, HKD港幣, GBP英鎊, EUR歐元 |
不可空 |
|
orderAmount |
訂單金額 |
String(18) |
整型數(shù)字
除了日元、韓元為元，其他幣種為分 |
不可空 |
|
payCurrencyCode |
支付幣種 |
String(3) |
CNY人民幣USD美元EUR歐元RUB盧布JPY日元 |
不可空 |
|
rates |
匯率 |
String(20) |
精確到小數(shù)點后5位 |
不可空 |
|
paidAmount |
實際支付金額 |
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 |
錯誤代碼 |
String(10) |
失敗時返回的錯誤代碼 |
可空 |
|
errMsg |
錯誤信息 |
String(256) |
失敗時返回的錯誤信息 |
可空 |
|
riskLevel |
風(fēng)險等級 |
String(2) |
00無風(fēng)險，01風(fēng)控拒絕，02可疑
03交易滯留 |
可空 |
|
riskOccurCount |
風(fēng)險訂單累計數(shù)量 |
String(4) |
風(fēng)險訂單累計數(shù)量 |
可空 |
|
riskDesc |
風(fēng)險描述 |
String(256) |
風(fēng)險備注 |
可空 |
|
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¤cyCode=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后臺通過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 功能概要
商戶查詢接口實現(xiàn)：在商戶網(wǎng)站查詢在MasaPay某段時間的交易記錄或某筆交易記錄。
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) |
商戶開戶時由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é)束時間批量查詢,只返回成功訂單 |
不可空 |
|
masapayOrderNo |
交易流水號 |
String(16) |
查詢方式為0時必填 |
可空 |
|
merchantOrderNo |
商戶訂單號 |
String(64) |
查詢方式為1時必填 |
可空 |
|
startTime |
訂單提交開始時間 |
String(14) |
查詢方式為2時必填
年月日時分秒如：20121117020101 |
可空 |
|
endTime |
訂單提交結(jié)束時間 |
String(14) |
查詢方式為2時必填
年月日時分秒如：20121117020101限制時間段14天內(nèi)，跨度24小時 |
可空 |
|
signMsg |
簽名字符串 |
String(256) |
參見簽名元素說明 |
不可空 |
備注：
如果商戶指定了重復(fù)提交，根據(jù)商戶訂單號查詢將可能會返回多條結(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) |
商戶開戶時由MasaPay分配 |
不可空 |
|
charset |
編碼字符集 |
String(10) |
如：gbk，gb2312，utf-8，Shift-JIS |
不可空 |
|
language |
語言 |
String(2) |
cn中文 en 英文 ru俄文 jp日文 |
不可空 |
|
signType |
簽名方式 |
String(8) |
SHA256，MD5可選 |
不可空 |
|
errCode |
錯誤代碼 |
String(10) |
失敗時返回的錯誤代碼 |
可空 |
|
errMsg |
錯誤信息 |
String(256) |
失敗時返回的錯誤信息 |
可空 |
|
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 |
提交時間 |
String(14) |
年月日時分秒如：20121117020101 |
不可空 |
|
dealTime |
交易時間 |
String(14) |
年月日時分秒如：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 |
實際支付金額 |
String(18) |
整型數(shù)字
除了日元、韓元為元，其他幣種為分 |
不可空 |
|
currencyCode |
幣種 |
String(3) |
CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門元, MYR馬來西亞, NZD新西蘭元, CHF瑞士法郎, THB泰銖, TWD新臺幣, KRW韓元, INR印度盧比, CAD加元, AUD澳元, HKD港幣, GBP英鎊, EUR歐元 |
不可空 |
|
payCurrencyCode |
支付幣種 |
String(3) |
CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門元, MYR馬來西亞, NZD新西蘭元, CHF瑞士法郎, THB泰銖, TWD新臺幣, KRW韓元, INR印度盧比, CAD加元, AUD澳元, HKD港幣, GBP英鎊, EUR歐元 |
不可空 |
|
rates |
匯率 |
String(20) |
精確到小數(shù)點后5位 |
不可空 |
|
riskLevel |
風(fēng)險等級 |
String(2) |
00無風(fēng)險，01風(fēng)控拒絕，02可疑
03交易滯留 |
可空 |
|
riskOccurCount |
風(fēng)險訂單累計數(shù)量 |
String(4) |
風(fēng)險訂單累計數(shù)量 |
可空 |
|
riskDesc |
風(fēng)險描述 |
String(256) |
風(fēng)險備注 |
可空 |
|
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¤cyCode=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ù)的款項全部或部分退還給用戶
商戶退款通知接口：在退款成功后，通知商戶系統(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) |
商戶開戶時由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新臺幣, KRW韓元, INR印度盧比, CAD加元, AUD澳元, HKD港幣, GBP英鎊, EUR歐元 |
不可空 |
|
refundSubmitTime |
退款提交時間 |
String(14) |
年月日時分秒
如：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¤cyCode=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) |
商戶開戶時由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 |
錯誤信息 |
String(256) |
失敗時返回的錯誤信息 |
可空 |
|
refundOrderNo |
退款訂單號 |
String(32) |
與提交時退款流水號保持一致 |
不可空 |
參與簽名元素說明：
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)
通知地址：商戶退款時提供的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 |
提交時間 |
String(14) |
商戶提交退款訂單的時間，年月日時分秒如：20121117020101 |
不可空 |
|
dealTime |
交易完成時間 |
String(14) |
MasaPay退款交易完成時間，年月日時分秒如：20121117020101 |
不可空 |
|
currencyCode |
幣種 |
String(3) |
CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門元, MYR馬來西亞, NZD新西蘭元, CHF瑞士法郎, THB泰銖, TWD新臺幣, 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¤cyCode=CNY&refundAmount=100&resultCode=10&key={key}
簽名方法示例說明：
詳情參考附錄8.1簽名方法示例說明
6.4.2 應(yīng)答
MasaPay后臺通過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某段時間的交易記錄或某筆交易記錄。
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) |
商戶開戶時由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é)束時間批量查詢，只返回成功訂單 |
不可空 |
|
refundOrderNo |
退款訂單號 |
String(30) |
查詢方式為0時必填，商戶生成的唯一退款流水號 |
不可空 |
|
startTime |
退款提交起始時間 |
String(14) |
查詢方式為1時必填，年月日時分秒如：20121117020101 |
可空 |
|
endTime |
退款提交結(jié)束時間 |
String(14) |
查詢方式為1時必填，年月日時分秒如：20121117020101限制查詢時間段14天內(nèi)，跨度24小時 |
可空 |
|
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) |
商戶開戶時由MasaPay分配 |
不可空 |
|
charset |
編碼字符集 |
String(10) |
如：gbk，gb2312，utf-8，Shift-JIS |
不可空 |
|
language |
語言 |
String(2) |
cn中文 en 英文 ru俄文 jp日文 |
不可空 |
|
signType |
簽名方式 |
String(8) |
SHA256，MD5可選 |
不可空 |
|
errCode |
錯誤代碼 |
String(10) |
失敗時返回的錯誤代碼 |
可空 |
|
errMsg |
錯誤信息 |
String(256) |
失敗時返回的錯誤信息 |
可空 |
|
recordCount |
記錄集總條數(shù) |
String(10) |
|
不可空 |
|
signMsg |
簽名字符串 |
String(256) |
參見簽名元素說明 |
不可空 |
|
訂單信息(list) |
|
refundOrderNo |
退款訂單號 |
String(30) |
商戶生成的唯一退款流水號 |
不可空 |
|
merchantOrderNo |
原商戶訂單號 |
String(64) |
原商戶訂單號 |
不可空 |
|
masapayRefundOrderNo |
退款流水號 |
String(16) |
MasaPay系統(tǒng)退款流水號 |
不可空 |
|
refundAmount |
實際退款金額 |
String(18) |
整型數(shù)字
除了日元、韓元為元，其他幣種為分 |
不可空 |
|
currencyCode |
幣種 |
String(3) |
CNY人民幣，USD美元，EUR歐元，RUB盧布，JPY日元, MOP澳門元, MYR馬來西亞, NZD新西蘭元, CHF瑞士法郎, THB泰銖, TWD新臺幣, KRW韓元, INR印度盧比, CAD加元, AUD澳元, HKD港幣, GBP英鎊, EUR歐元 |
不可空 |
|
submitTime |
退款提交時間 |
String(14) |
年月日時分秒如：20121117020101 |
不可空 |
|
dealTime |
退款交易時間 |
String(14) |
年月日時分秒如：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¤cyCode=CNY&submitTime=20121117020101&dealTime=20121117020101&status=P&key={key}
簽名方法示例說明：
詳情參考附錄8.1簽名方法示例說明
8 API快遞單上傳業(yè)務(wù)
8.1 功能概要
快遞單上傳接口實現(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) |
商戶開戶時由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 |
配送時間 |
String(14) |
年月日時分秒如：20121117020101 |
不可空 |
|
etaDate |
預(yù)計妥投時間 |
String(14) |
年月日時分秒如：20121117020101 |
不可空 |
|
expressNo |
快遞單號 |
String(32) |
快遞公司下單時訂單號 |
不可空 |
|
expressCompany |
快遞公司 |
String(60) |
快遞公司名稱 |
不可空 |
|
expressUrl |
查單網(wǎng)址 |
String(200) |
快遞公司查詢訂單網(wǎng)址 |
不可空 |
|
uploadDate |
上傳時間 |
String(14) |
年月日時分秒如：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) |
商戶開戶時由MasaPay分配 |
不可空 |
|
charset |
編碼字符集 |
String(10) |
如：gbk，gb2312，utf-8，Shift-JIS |
不可空 |
|
language |
語言 |
String(2) |
cn中文 en 英文 ru俄文 jp日文 |
不可空 |
|
signType |
簽名方式 |
String(8) |
SHA256，MD5可選 |
不可空 |
|
errCode |
錯誤代碼 |
String(10) |
失敗時返回的錯誤代碼 |
可空 |
|
errMsg |
錯誤信息 |
String(256) |
失敗時返回的錯誤信息 |
可空 |
|
expressCount |
快遞單總數(shù) |
String(10) |
成功收到快遞單總數(shù)量 |
不可空 |
|
signMsg |
簽名字符串 |
String(256) |
參見簽名元素說明 |
不可空 |
|
未成功快遞單信息list |
|
merchantOrderNo |
商戶訂單號 |
String(64) |
原商戶支付訂單號 |
不可空 |
|
expressDate |
配送時間 |
String(14) |
年月日時分秒如：20121117020101 |
不可空 |
|
etaDate |
預(yù)計妥投時間 |
String(14) |
年月日時分秒如：20121117020101 |
不可空 |
|
expressNo |
快遞單號 |
String(32) |
快遞公司下單時訂單號 |
不可空 |
|
expressCompany |
快遞公司 |
String(60) |
快遞公司名稱 |
不可空 |
|
expressUrl |
查單網(wǎng)址 |
String(200) |
快遞公司查詢訂單網(wǎng)址 |
不可空 |
|
uploadDate |
上傳時間 |
String(14) |
年月日時分秒如：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^商品單價1^商品展示網(wǎng)址1|商品名稱2^商品規(guī)格2^購買數(shù)量2^商品單價2^商品展示網(wǎng)址2¤cyCode=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^商品單價1^商品展示網(wǎng)址1|商品名稱2^商品規(guī)格2^購買數(shù)量2^商品單價2^商品展示網(wǎng)址2¤cyCode=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=®isterTime=®isterIp=®isterTerminal=&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¤cyCode=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¤cyCode=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)返回報文有errorCode的時候，masapay對返回報文不做加簽，同時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)可。 |
