京東支付手機網(wǎng)頁即時到賬接口

1、“京東支付”支付手機網(wǎng)頁即時到帳接口 19/19京東支付手機網(wǎng)頁即時到賬接口版本 (V1.0.0)網(wǎng)銀在線（北京）科技有限公司目錄 TOC o 1-3 h z u HYPERLINK l _Toc410206639 1文檔說明 PAGEREF _Toc410206639 h 3 HYPERLINK l _Toc410206640 1.1功能描述 PAGEREF _Toc410206640 h 3 HYPERLINK l _Toc410206641 1.2閱讀對象 PAGEREF _Toc410206641 h 3 HYPERLINK l _Toc410206642 1.3術語 PAGEREF

2、_Toc410206642 h 3 HYPERLINK l _Toc410206643 2京東支付流程 PAGEREF _Toc410206643 h 4 HYPERLINK l _Toc410206644 3接口 PAGEREF _Toc410206644 h 4 HYPERLINK l _Toc410206645 3.1支付請求接口參數(shù) PAGEREF _Toc410206645 h 4 HYPERLINK l _Toc410206646 3.1.1接口介紹 PAGEREF _Toc410206646 h 4 HYPERLINK l _Toc410206647 3.1.2參數(shù)列表 PAGE

3、REF _Toc410206647 h 5 HYPERLINK l _Toc410206648 3.1.3參數(shù)特殊說明 PAGEREF _Toc410206648 h 5 HYPERLINK l _Toc410206649 3.1.4敏感信息加密 PAGEREF _Toc410206649 h 6 HYPERLINK l _Toc410206650 3.1.5樣例 PAGEREF _Toc410206650 h 6 HYPERLINK l _Toc410206651 3.2異步通知參數(shù) PAGEREF _Toc410206651 h 7 HYPERLINK l _Toc410206652 3.

4、2.1說明 PAGEREF _Toc410206652 h 7 HYPERLINK l _Toc410206653 3.2.2通知報文列表 PAGEREF _Toc410206653 h 7 HYPERLINK l _Toc410206654 3.2.3通知報文特殊說明 PAGEREF _Toc410206654 h 8 HYPERLINK l _Toc410206655 3.2.4樣例 PAGEREF _Toc410206655 h 8 HYPERLINK l _Toc410206656 3.3退款申請接口 PAGEREF _Toc410206656 h 9 HYPERLINK l _Toc

5、410206657 3.3.1說明 PAGEREF _Toc410206657 h 9 HYPERLINK l _Toc410206658 3.3.2退款申請接口參數(shù)列表 PAGEREF _Toc410206658 h 10 HYPERLINK l _Toc410206659 3.3.3退款申請返回參數(shù)列表 PAGEREF _Toc410206659 h 11 HYPERLINK l _Toc410206660 3.4交易查詢接口 PAGEREF _Toc410206660 h 12 HYPERLINK l _Toc410206661 3.4.1說明 PAGEREF _Toc410206661

6、 h 12 HYPERLINK l _Toc410206662 3.4.2查詢接口請求參數(shù)列表 PAGEREF _Toc410206662 h 12 HYPERLINK l _Toc410206663 3.4.3查詢接口返回參數(shù)列表 PAGEREF _Toc410206663 h 13 HYPERLINK l _Toc410206664 4附錄 PAGEREF _Toc410206664 h 14 HYPERLINK l _Toc410206665 4.1交易返回狀態(tài)編碼表 PAGEREF _Toc410206665 h 14 HYPERLINK l _Toc410206666 4.2交易返回

7、信息編碼表 PAGEREF _Toc410206666 h 14 HYPERLINK l _Toc410206667 4.3交易類型編碼表 PAGEREF _Toc410206667 h 16 HYPERLINK l _Toc410206668 4.4京東支付退款/查詢RSA公鑰 PAGEREF _Toc410206668 h 161文檔說明功能描述京東支付手機網(wǎng)頁即時到帳接口為第三方手機網(wǎng)頁應用提供發(fā)起支付請求, 并引導用戶完成支付過程。支付完成以后，通過同步、異步兩種方式通知第三方網(wǎng)頁應用服務器。它的優(yōu)勢是支付金額即時從消費者的銀行賬戶扣除，用戶支付過程簡便、安全，界面新穎，再次支付更加便

8、捷。同時，京東支付又提供了自動退款，以及交易結果查詢接口。交易結果查詢接口是為了防止商戶長時間沒有接收到同步、異步結果通知的情況而設計，在這種情況下，商戶可以通過交易查詢接口進行單筆或者批量查詢交易結果，進而更新用戶訂單狀態(tài)。閱讀對象本文檔面向商戶系統(tǒng)設計人員、編程人員及測試人員。該人員需要具備一定的網(wǎng)站開發(fā)能力，了解ASP、PHP、JAVA、ASP.NET等開發(fā)語言中的一種及SQL數(shù)據(jù)庫語言。術語名詞解釋商戶指已注冊成為網(wǎng)銀在線支付產(chǎn)品的用戶、并使用網(wǎng)銀在線產(chǎn)品實現(xiàn)其收付費功能需求、為其用戶提供各類產(chǎn)品或者相關服務的企業(yè)或個人。消費者（用戶）指在商戶網(wǎng)站等系統(tǒng)購物的企業(yè)或個人。請求通過HTT

9、P/HTTPS協(xié)議把數(shù)據(jù)發(fā)送給接收方的過程。通知京東支付服務器異步通知。京東支付服務器根據(jù)接收到的數(shù)據(jù)處理完成后，會主動發(fā)起通知給商戶的服務器，同時攜帶處理結果信息。返回 頁面跳轉同步通知。京東支付服務器根據(jù)接收到的數(shù)據(jù)處理完成后，當前頁面從京東支付的頁面自動跳轉回商戶頁面，同時攜帶處理結果信息。支付失敗 手機號被凍結、商戶違約被凍結支付功能、余額不足、超額、訂單已支付、訂單金額和支付金額不一致等都會導致支付失敗。京東支付流程用戶首先在商戶系統(tǒng)的頁面上選擇商品并下單，點擊支付按鈕以后，商戶系統(tǒng)向京東支付服務支付接口發(fā)起支付請求。商戶要根據(jù)京東支付接口要求，通過程序得到簽名結果以及要傳給京東支付

10、服務的訂單信息以及商戶信息數(shù)據(jù)集合。在支付請求的時候把數(shù)據(jù)集合發(fā)送到京東支付服務器。京東支付服務會首先驗證商戶的合法性，以及驗證訂單金額是否被篡改，如果商戶非法，或者訂單信息被篡改，京東支付服務會直接拒絕此支付請求；反之，則重定向到支付頁面，引導用戶填入支付的身份信息和銀行卡信息，在用戶確認之后，從用戶的銀行卡扣除相應的金額。如果支付完成以后，京東支付服務會跳轉到商戶支付請求的時候傳入的url，并攜帶支付結果。并且，如果支付成功，京東支付服務后臺會發(fā)送異步通知到商戶傳入的通知地址，把支付結果通知商戶。接口支付請求接口參數(shù)接口介紹支付請求接口提供給商戶向京東支付服務發(fā)送支付請求數(shù)據(jù)集合，京東支付

11、服務會根據(jù)請求數(shù)據(jù)驗證商戶身份，以及驗證支付信息是否被篡改。驗證通過后，京東支付服務會把當前頁面重定向到支付頁面。如果驗證未通過，京東支付服務會把當前頁面重定向到商戶系統(tǒng)傳入的支付失敗頁面。調用地址：HYPERLINK /wepay/web/pay/wepay/web/pay編碼格式: UTF-8調用方式：post數(shù)據(jù)格式：Form表單參數(shù)列表序號參數(shù)名稱參數(shù)編碼必填參數(shù)類型描述1版本號version是String2.0（注：1.0版本不再支持）2用戶交易令牌token否String識別用戶信息,支付成功后會調用successCallbackUrl返回給商戶。（注:商戶可以記錄這個token值

12、，當用戶再次支付的時候傳入該token，用戶無需再次輸入銀行卡信息，直接輸入短息驗證碼進行支付。）3交易信息簽名merchantSign是String用戶交易信息簽名后的值4商戶號merchantNum是String(50)商戶在網(wǎng)銀登記的商戶號5商戶備注merchantRemark否String(64)商戶備注信息6交易流水號tradeNum是String(30)商戶提供的唯一交易流水號（字母和數(shù)字）7交易名稱tradeName是String（256）商戶提供的訂單的標題/商品名稱/關鍵字等8交易描述tradeDescription否String(100)商戶提供的訂單的具體描述信息9交易時

13、間tradeTime是Date商戶提供的訂單的時間，格式為“年-月-日 時:分:秒”例：2014-06-11 10:11:1110交易金額tradeAmount是int商戶提供的訂單的資金總額，單位：分，大于0。 11貨幣種類currency是String貨幣類型，固定填CNY12支付成功頁面跳轉路徑successCallbackUrl是String(300)支付成功后跳轉的URL,13支付失敗頁面跳轉路徑failCallbackUrl是String(300)支付失敗時跳轉到商戶的URL14異步通知地址notifyUrl是String(100)支付完成后，異步通知商戶服務相關支付結果參數(shù)特殊說

14、明在以上的請求參數(shù)中，商戶號是在網(wǎng)銀在線注冊開通京東支付功能的時候，網(wǎng)銀在線商戶管理系統(tǒng)為用戶分配的。用戶的交易令牌在用戶第一次支付的時候是沒有的。支付成功以后，該用戶的交易令牌會同步返回給商戶系統(tǒng)，商戶系統(tǒng)可以為該用戶存儲此交易令牌，并在下一次支付請求時候將令牌傳給京東支付服務。如果支付請求時攜帶用戶交易令牌，那么在支付過程中就不需要用戶再填寫手機號碼、身份信息和銀行卡信息。交易流水號是用來標識每次支付請求的號碼，需要商戶保證在每一次支付請求的時候交易流水號唯一，多次請求不能使用同一交易流水號，否則京東支付服務在處理后面的支付請求時，會把此交易當做重復支付處理。交易信息簽名使用的簽名類型為R

15、SA(javaRSA補位方式為 RSA/ECB/PKCS1Padding)。簽名的內容為除merchantSign和version, token外所有參數(shù)按字母由a-z的順序排序后以&符號連接生成源串，其中非必填字段如無值則使用空串，最后一位&要去掉（例如a=1&b=&c=3）。首先把源串使用sha-256加密sha-256加密后轉成16進制的字符串作為簽名摘要(16進制字母小寫，16進制不足2位時在前補”0”),使用RSA對簽名摘要進行加密生成簽名 (RSA加密后為byte數(shù)組,使用標準BASE64轉換為字符串)。注:RSA簽名以及驗簽的時候使用的密鑰是商戶通過OPENSSL生成的，商戶生成

16、RSA密鑰對之后需要把公鑰配置到網(wǎng)銀商戶管理后臺，使用商戶的私鑰進行簽名，京東支付服務會使用商戶公鑰對簽名進行校驗。支付成功跳轉路徑,當商戶的一次支付請求成功完成支付時,京東支付可將請求重定向到此路徑(此操作是用戶的可選操作),并在路徑后添加 “?token=xxxx&tradeNum=xxxx” 參數(shù),以便商戶進行訂單信息的付款狀態(tài)展示(注:商戶的真正的訂單狀態(tài)不能依據(jù)此請求,此路徑只用作展示)支付失敗跳轉路徑,當商戶的支付請求支付失敗時, 京東支付可將請求重定向到此路徑(此操作是用戶的可選操作),并在路徑后添加“?tradeNum=xxxx”,商戶可用于訂單信息的狀態(tài)展示(注: 商戶的真正

17、的訂單狀態(tài)不能依據(jù)此請求)異步通知地址, 支付完成后，異步通知商戶服務相關支付結果,(真正的支付結果以此通知為準)敏感信息加密支付請求參數(shù)中的敏感信息包括序號5至14的參數(shù),在最終提交form表單時,需要進行加密處理(交易簽名在此步驟之前),參數(shù)中值為空的不進行加密,所有參數(shù)以字符串類型進行加密敏感信息加密流程:將網(wǎng)銀分配給商戶的deskey 進行BASE64解碼,解碼后為byte數(shù)組,取前8字節(jié)為key以8字節(jié)的key為秘鑰對參數(shù)進行des加密將des加密結果進行BASE64編碼為最終結果樣例簽名源串樣例（其中tradeDescription參數(shù)為非必填。）currency=CNY&fail

18、CallbackUrl=&merchantNum=22312781&merchantRemark=商戶備注¬ifyUrl=&successCallbackUrl=&tradeAmount=10&tradeDescription=&tradeName=交易名稱&tradeNum=20001&tradeTime=2014-08-16 15:53:08支付請求數(shù)據(jù)集合參數(shù)樣例 異步通知參數(shù)說明異步通知是在支付成功/失敗,退款成功/失敗的情況下，由網(wǎng)銀在線的異步通知服務器自動發(fā)送給商戶服務器。通知地址就是商戶支付請求的時候傳入的notifyUrl參數(shù)，對于異步通知，網(wǎng)銀異步通知系統(tǒng)根據(jù)商戶通知地

19、址的http訪問狀態(tài)碼和返回內容來判斷通知是否成功，當收到處理成功標示后，系統(tǒng)不再發(fā)送異步通知。否者，會重復發(fā)送異步通知，最多發(fā)送5次，時間點分別為支付完成后、支付完成后1分鐘、支付完成后3分鐘、支付完成后10分鐘、支付完成后120分鐘。支付成功標示為返回碼“200”并且返回內容“success”，其他返回內容均認為商戶系統(tǒng)處理異步通知失敗。通知報文列表報文參數(shù)數(shù)據(jù)格式二級參數(shù)三級參數(shù)參數(shù)名稱參數(shù)說明VERSION明文版本號1.0.0MERCHANT明文商戶號由網(wǎng)銀在線提供TERMINAL明文終端號由網(wǎng)銀在線提供DATA按二級參數(shù)和三級參數(shù)組成XML格式數(shù)據(jù)，然后使用3DES加密。TRADET

20、YPE交易類型Q（返回原交易類型）見附錄 HYPERLINK l _交易類型編碼表 4.3ID交易號數(shù)字或字母AMOUNT交易金額單位：分CURRENCY交易幣種人民幣：CNYDATE交易日期yyyyMMddTIME交易時間HHmmssNOTE交易備注返回原交易備注，如果沒有備注就沒有這個參數(shù)STATUS交易返回狀態(tài)成功：0 處理中：6 失?。?RETRUNCODE交易返回碼見附錄 HYPERLINK l _交易返回信息編碼表 4.2DESC交易返回碼信息見附錄 HYPERLINK l _交易返回信息編碼表 4.2SIGN明文數(shù)據(jù)簽名MD5簽名，簽名數(shù)據(jù)為所有報文參數(shù)加簽名密鑰。通知報文特殊說

21、明網(wǎng)銀在線異步通知報文均經(jīng)過base64編碼，商戶服務器收到報文之后需要先做base64反轉，之后得到報文內容。通知報文為xml格式，明文和簽名一同發(fā)給商戶服務器。DATA域是用商戶在網(wǎng)銀注冊時候給商戶生成的DES密鑰(實際密鑰為密鑰字符串經(jīng)BASE64解碼取前8個字節(jié))加密后經(jīng)過BASE64編碼的字符串數(shù)據(jù)。簽名的源串是將參數(shù)VERSION, MERCHANT, TERMINAL, DATA的值按照報文格式順序，拼接成字符串，加上商戶的MD5密鑰，中間沒有任何連接符。簽名類型是MD5簽名(結果為16進制小寫字符串)。樣例收到的響應參數(shù)為resp=PD94bWwgdmVyc2lvbj0iMS4

22、wIiBlbmNvZGluZz0iVVRGLTgiPz4NCjxDSElOQUJBTks+DQogICAgPFZFUlNJT04+MS4wLjA8L1ZFUlNJT04+DQogICAgPE1FUkNIQU5UPjIyMzEwMzE4PC9NRVJDSEFOVD4NCiAgICA8VEVSTUlOQUw+MDAwMDAwMDE8L1RFUk1JTkFMPg0KICAgIDxEQVRBPk42NG1ZWUtKbG93eFhjRHFkSnNMcUZ6MUVQMWZ4bGQwamdHVm1La2FiT0ZXeE9sTU5VWHdBcGNKa24zajZOWE05eVRyOGdIbW9jdjQKTys

23、xTzErVXMxVk1wVzRaUWFiZjdleDNQZWEzMko5VW5vK21LRTlGYnkzMXBhVXFTWlFXRFFqMGlhK3hGVWMvVU16N2EwdWZHZmliNQplQWhpTUZMa0pMaWJGeS9zSmw4QXBWdVRUY3FnOFBjQXdqRHF2R0F2OTd3MHhyYmVLeDl5YmdpSk5xelF0ZjFGZVhFTlllVTZZU2lVClpPQjhyVS9xUW9nSnJ2L2crQUJzY1Iwa0tkM24rRHZ0VHRmbExOWHdJTDh3aHNyaUxBV3BrKzRCdW82aHZsV3U3OXpwWUJXQXJ

24、JVS8KdTQycDJFbUYwZHZKRmpTU1BPdjN1Q2paOGlSSzdyV3U0SXlBWGs2cmd2LzdoS1hEbzBLeCtRMUFnbjdiUFIzQVNRcUp2U1lvdit5bAplMkpYZHBmeTNyVU9VZjQ9PC9EQVRBPg0KICAgIDxTSUdOPjE5ZjljZTMyYmU0MTRlZjgyYjg0YTkwNzk0OTNiNzFhPC9TSUdOPg0KPC9DSElOQUJBTks+將得到的resp參數(shù)依據(jù)字符集經(jīng)過BASE64解碼得到 1.0.0 22310318 00000001N64mYYKJlowxXcDqdJsLqFz1

25、EP1fxld0jgGVmKkabOFWxOlMNUXwApcJkn3j6NXM9yTr8gHmocv4O+1O1+Us1VMpW4ZQabf7ex3Pea32J9Uno+mKE9Fby31paUqSZQWDQj0ia+xFUc/UMz7a0ufGfib5eAhiMFLkJLibFy/sJl8ApVuTTcqg8PcAwjDqvGAv97w0 xrbeKx9ybgiJNqzQtf1FeXENYeU6YSiUZOB8rU/qQogJrv/g+ABscR0kKd3n+DvtTtflLNXwIL8whsriLAWpk+4Buo6hvlWu79zpYBWArIU/u42p2EmF0dvJFjSSPOv

26、3uCjZ8iRK7rWu4IyAXk6rgv/7hKXDo0Kx+Q1Agn7bPR3ASQqJvSYov+yle2JXdpfy3rUOUf4= 19f9ce32be414ef82b84a9079493b71a其中簽名的源串為VERSION+MERCHANT+TERMINAL+DATA+密鑰，并且不帶任何連接符，即“1.0.02231031800000001N64mYYKJlowxXcDqdJsLqFz1EP1fxld0jgGVmKkabOFWxOlMNUXwApcJkn3j6NXM9yTr8gHmocv4O+1O1+Us1VMpW4ZQabf7ex3Pea32J9Uno+mKE9Fby31

27、paUqSZQWDQj0ia+xFUc/UMz7a0ufGfib5eAhiMFLkJLibFy/sJl8ApVuTTcqg8PcAwjDqvGAv97w0 xrbeKx9ybgiJNqzQtf1FeXENYeU6YSiUZOB8rU/qQogJrv/g+ABscR0kKd3n+DvtTtflLNXwIL8whsriLAWpk+4Buo6hvlWu79zpYBWArIU/u42p2EmF0dvJFjSSPOv3uCjZ8iRK7rWu4IyAXk6rgv/7hKXDo0Kx+Q1Agn7bPR3ASQqJvSYov+yle2JXdpfy3rUOUf4=”。值的明文需要通過DES密鑰(實際密鑰為密

28、鑰字符串經(jīng)BASE64解碼取前8個字節(jié))解密后得到。樣例中使用的DES密鑰為: xBxXFRV2KrzsokwmyyZJ5qQCxJcEW7y8退款申請接口說明退款申請接口提供給商戶發(fā)起自動退款的能力。如果用戶在商戶系統(tǒng)下單支付以后發(fā)起退款，商戶驗證通過之后可以自動發(fā)起退款請求。同時網(wǎng)銀在線商戶管理后臺提供手動退款的功能。調用地址：HYPERLINK /wepay/web/pay/wepay/refund編碼格式: UTF-8調用方式：post數(shù)據(jù)格式：json退款申請接口參數(shù)列表序號參數(shù)名稱參數(shù)編碼必填參數(shù)類型描述1版本號version是String1.0（固定值）2商戶號merchantN

29、um是String3申請數(shù)據(jù)data是String退款申請需要的信息3DES4用戶退款流水信息簽名merchantSign是StringRSASHA256dataExampleversion: 1.0, merchantNum: 22294531 , merchantSign: g8HFddOKsvzRgrpNWmo31bLxkiuh6NWch22Hc5sDKJ7LebrXcbxVZhacTcG7423j8L96iCTbNGFQpYQ51lc250lQj+KLsBOidMRyiNvaMfDErv08zGc/lT6FsTXh3EG97nhbOtAw8kwPzTleku4aoy1k3EKuJlhD

30、PCvq3QZ/8XQ=, data: 678c41554777b50774d30e2da6cbd765946fbe95c1214ce3b6238bf4ba034c8391027712af62c26177fc7fa0945211c82155c69827c2213661ca56918027c4ba3fc25905f0478dcf10c2a0a3596f236b89dbd6b285b2d18ec796901f05adaa4be1ce16ff74409d0fe27923eb53fe91d83b4785e0f312553c6f74f80f75f2e70960d837f584d13eae4b4c5b79

31、3c80b9ade53adc5281edc1a46eb761a7ce35a7a097e5ea67a6d1ea8aab8655604daa8b53f9f355767c596af72d4701b95b31a679e0f5339997b01c6df304b6eaf9b61d7cb2d3071c462a73964942253d89c026d49335cc2fc785c26bdata域的參數(shù)包括：序號參數(shù)名稱參數(shù)編碼必填參數(shù)類型描述1交易流水號tradeNum是String不支持批量,數(shù)字或字母，標識本次請求2原交易流水號oTradeNum是String數(shù)字或字母，標識需要退款的那筆交易流水。3交易金額

32、 tradeAmount是String單位：分4交易幣種tradeCurrency是StringCNY5交易日期tradeDate否String(8)yyyyMMdd6交易時間tradeTime否String(6)HHmmss7交易通知地址tradeNotice否String如果為空，交易結束后不主動向商戶發(fā)送結果通知8交易備注tradeNote否StringExample tradeNum: 12345, oTradeNum: 1234, tradeAmount: 1, tradeCurrency: CNY, tradeDate: , tradeTime: , tradeNotice: ,

33、tradeNote: 申請數(shù)據(jù)（data）需要做3DES加密，（data首先轉換為byte 數(shù)組, byte數(shù)組分為兩段數(shù)據(jù)，前4字節(jié)為有效信息長度，后面為有效數(shù)據(jù)本身,如4字節(jié)長度信息加byte數(shù)組長度不滿8的整數(shù)倍，使用0 x00補齊加密前數(shù)據(jù)。3DES加密前輸入數(shù)據(jù)的前明文格式如下：如：“0X0000000301020300”。0X00000003為有效數(shù)據(jù)長度，0X010203為3個字節(jié)的有效信息，后面加1個字節(jié)的0X00補位，使總數(shù)據(jù)段為8字節(jié)的整數(shù)倍；Data數(shù)據(jù)byte長度占4字節(jié)Data數(shù)據(jù)byte內容補齊位（如4字節(jié)長度與data長度總和不是8的整數(shù)倍，將進行補位）0X000

34、000030X0102030X003DES密鑰是商戶在注冊京東支付服務的時候網(wǎng)銀在線商戶管理后臺為用戶生成的。實際密鑰為密鑰字符串經(jīng)BASE64解碼取前24個字節(jié)申請數(shù)據(jù)加密流程： 1 拼接有效信息長度與信息本身。 2 使用0 x00補齊拼接信息，使拼接信息為8字節(jié)的整數(shù)倍。 3.使用實際秘鑰對當前拼接信息進行3DES加密。4.將加密后的數(shù)據(jù)轉化為16進制格式(0-9,a-f小寫字母)字符串）作為最終申請數(shù)據(jù)(data)。用戶退款流水信息簽名流程:對最終申請數(shù)據(jù)(data)進行SHA-256加密轉成16進制的字符串(16進制字母小寫)進行RSA加密(javaRSA補位方式為 RSA/ECB/P

35、KCS1Padding)。RSA加密用到的私鑰是需要商戶使用OPENSSL生成的，公鑰需要配置到京東支付服務端，以便京東支付服務驗簽。進行BASE64編碼生成簽名字符串(merchantSign)退款申請返回參數(shù)列表序號參數(shù)名稱參數(shù)編碼必填類型描述1返回碼resultCode是String2返回描述信息resultMsg是String3返回數(shù)據(jù)resultData是Object其中resultData數(shù)據(jù)字段是：序號參數(shù)名稱參數(shù)編碼必填類型描述1返回數(shù)據(jù)信息data是String2返回數(shù)據(jù)簽名sign是String其中，返回數(shù)據(jù)信息（data）已經(jīng)做了3DES加密(參閱 HYPERLINK l

36、 _退款申請接口參數(shù)列表 3.3.2退申請數(shù)據(jù)加密流程) 。返回數(shù)據(jù)簽名(參閱 HYPERLINK l _退款申請接口參數(shù)列表 3.3.2用戶退款流水信息簽名流程)注:返回數(shù)據(jù)簽名中RSA加密用到的私鑰是在商戶注冊京東支付服務的時候網(wǎng)銀在線生成的，公鑰會交換給商戶，以便商戶服務器對返回信息驗簽。其中，data域的參數(shù)包括：序號參數(shù)名稱參數(shù)編碼類型描述1交易號tradeNumString標識本次請求2原交易流水號oTradeNumString標識需要退款的那筆交易流水。3交易金額tradeAmountString單位：分4交易幣種tradeCurrencyString5交易日期tradeDate

37、String(8)yyyyMMdd6交易時間tradeTimeString(6)HHmmss7交易備注tradeNoteString8交易狀態(tài)tradeStatusString(1)成功：0處理中：6 失敗：7交易查詢接口說明交易查詢接口是為了處理商戶服務器長時間沒有接收到支付結果的情況設計的。一般情況，支付結果會通過前端同步返回和網(wǎng)銀在線服務器的異步通知發(fā)動到商戶服務。但是為避免特殊情況商戶服務器仍然沒有接收到支付結果，這時候商戶服務可以通過主動查詢交易結果的接口查詢支付狀態(tài)。查詢交易結果接口支持批量查詢功能。調用地址：/wepay/query編碼格式: UTF-8調用方式：post數(shù)據(jù)格式

38、：json查詢接口請求參數(shù)列表序號參數(shù)名稱參數(shù)編碼必填參數(shù)類型描述1版本號version是String1.0（固定值）2商戶號merchantNum是String3查詢請求數(shù)據(jù)data是String4用戶查詢信息簽名merchantSign是StringExample version: 1.0, merchantNum: 22312781, merchantSign: K45bt+gnXFB5p1DZCpkZoES/v9gFeQJ+UTyKLRKXqTwTzS7knNOXkidvzbnoh58Al5eWifNXMA6Orn5W418S5msmG96rMajX12LJei5IWurpViVKyG

39、SXGOgifEYlqsRshS8xBd94h0keZ/nrTP3GBiIDZ8rn5kHSNs57Lhsfa6w9S6Q=, data: 89f0575080f46e19de0749cc6759b10e2a897c3ce612b61d7b9de26eb7727e937ed7b98c0417f0ca其中，查詢請求數(shù)據(jù)data需要做3DES加密(參閱 HYPERLINK l _退款申請接口參數(shù)列表 3.3.2 退款申請中data的加密流程)。用戶查詢信息簽名(參閱 HYPERLINK l _退款申請接口參數(shù)列表 3.3.2 中的簽名流程)data域的參數(shù)包括：序號參數(shù)名稱參數(shù)編碼必填參數(shù)類型描述

40、1交易流水號tradeNum是String多個流水用英文逗號隔開,一次最多100個Example tradeNum: 12345查詢接口返回參數(shù)列表序號參數(shù)名稱參數(shù)編碼必填類型描述1返回碼resultCode是String2返回描述信息resultMsg是String3返回數(shù)據(jù)resultData是Object其中resultData數(shù)據(jù)字段是：序號參數(shù)名稱參數(shù)編碼必填類型描述1返回數(shù)據(jù)信息data是String2返回數(shù)據(jù)簽名sign是String其中，返回數(shù)據(jù)信息(data)已經(jīng)做了3DES加密(參閱 HYPERLINK l _退款申請接口參數(shù)列表 3.3.2退申請數(shù)據(jù)加密流程) 。返回數(shù)據(jù)

41、簽名(參閱 HYPERLINK l _退款申請接口參數(shù)列表 3.3.2用戶退款流水信息簽名流程)注:返回數(shù)據(jù)簽名中RSA加密用到的私鑰是在商戶注冊京東支付服務的時候網(wǎng)銀在線生成的，公鑰會交換給商戶，以便商戶服務器對返回信息驗簽。其中data數(shù)據(jù)字段是：序號參數(shù)名稱參數(shù)編碼類型描述1交易號tradeNumString2交易金額tradeAmountString單位：分3交易幣種tradeCurrencyString4交易日期 tradeDateString(8)yyyyMMdd5交易時間 tradeTimeString(6)HHmmss6交易備注tradeNoteString7交易狀態(tài)trade

42、StatusString成功：0退款：3 部分退款：4 處理中：6 失?。?附錄 交易返回狀態(tài)編碼表編碼含義0成功3退款4部分退款6處理中7失敗 交易返回信息編碼表返回碼返回信息0000成功0001處理中EEE0001系統(tǒng)異常EEE0002網(wǎng)絡異常EEE0003銀行異常EEE0004數(shù)據(jù)庫異常EES0001報文解析異常EES0002字符集不正確EES0003版本號不正確EES0004商戶號不正確EES0005終端號不正確EES0006交易數(shù)據(jù)不正確EES0007數(shù)據(jù)簽名不正確EES0008權限不正確EES0009密鑰不正確EES0010發(fā)卡行不正確EES0011卡類型不正確EES0012交易卡

43、號不正確EES0013卡有效期不正確EES0014卡安全碼不正確EES0015持卡人姓名不正確EES0016持卡人證件類型不正確EES0017持卡人證件號不正確EES0018持卡人手機號不正確EES0019交易類型不正確EES0020交易號不正確EES0021交易金額不正確EES0022交易幣種不正確EES0023交易日期不正確EES0024交易時間不正確EES0025交易通知地址不正確EES0026交易備注不正確EES0027交易驗證碼不正確EES0028交易卡號網(wǎng)銀不受理EES0029交易卡號商戶不受理EES0030交易受理銀行繁忙EES0031交易受理渠道繁忙EES0032交易重復EES0033交易號重復EES0034交易驗證碼申請不受理EES0035交易驗證碼過期EES0036交易不存在EES0037原交易號不正確EES0038原交易不允許此操作EES0039原交易處理中EES0040退款余額不足EES0041查詢銀行列表錯誤EES0042找不到相應