通聯(lián)收銀寶

1、<p><b>　　文檔屬性</b></p><p><b>　　修改記錄</b></p><p><b>　　目錄</b></p><p><b>　　目錄3</b></p><p><b>　　1產品概述4</b>&

2、lt;/p><p><b>　　2產品模式4</b></p><p>　　2.1標準訂單支付（查詢+支付+通知模式）4</p><p>　　a.當面付支付付款（主掃）時序圖及流程如下：4</p><p>　　b.當面付支付收款（被掃）時序圖及流程如下6</p><p>　　2.2非標訂單支付（

3、支付+通知模式）7</p><p>　　a.當面付支付付款（主掃）時序圖及流程如下7</p><p>　　b.當面付支付收款（被掃）時序圖及流程如下7</p><p>　　2.3.當面付撤銷9</p><p>　　3當面付訂單模式設置9</p><p>　　4當面付訂單模式場景示例圖12</p>

4、<p>　　5當面付訂單查詢結果個性化16</p><p><b>　　5.1前言16</b></p><p>　　5.2訂單詳情個性化16</p><p>　　5.3標簽詳述19</p><p>　　6開發(fā)對接步驟19</p><p><b>　　1產品概述&l

5、t;/b></p><p>　　當面付訂單支付產品為行業(yè)優(yōu)質商戶的訂單提供輕支付解決方案，在當面付的場景疊加了與商戶訂單系統(tǒng)交互，實現(xiàn)通過當面付的主掃或被掃完成對商戶訂單的支付和通知功能。</p><p><b>　　2產品模式</b></p><p>　　2.1標準訂單支付（查詢+支付+通知模式）</p><p>

6、;　　訂單對接的一種，需要向商戶系統(tǒng)查詢到訂單金額及詳情，確認后發(fā)起支付，交易完成后把訂單支付結果通知到商戶系統(tǒng)</p><p>　　a.當面付支付付款（主掃）時序圖及流程如下：</p><p>　　消費者用app（微信/支付寶/手Q）掃描商戶當面付二維碼，打開訂單h5頁面；</p><p>　　消費者在h5頁面輸入#訂單號變量（由商戶配置變量名稱，詳情到商服平臺-

7、）更多服務-）當面付配置-）訂單模式配置），提交下一步；</p><p>　　當面付通過訂單查詢接口提交變量到商戶訂單系統(tǒng)進行查詢，并返回訂單金額及詳情；</p><p>　　h5展示訂單總金額及詳情排版；</p><p>　　用戶確認金額提交支付；</p><p>　　當面付H5上送訂單交易至交易核心進行處理，并實時返回結果；</p&

8、gt;<p>　　交易核心異步將交易結果通知商戶系統(tǒng)。</p><p>　　b.當面付支付收款（被掃）時序圖及流程如下</p><p>　　商戶用收銀寶公眾號的收款功能輸入訂單號，點擊下一步，發(fā)送到商戶訂單系統(tǒng)進行訂單查詢；</p><p>　　商戶確認訂單詳情（金額+業(yè)務詳情參數(shù)）后，點擊“去掃碼”調起掃一掃</p><p>

9、　　掃碼消費者付款碼，進行當面付支付；</p><p><b>　　后臺返回交易結果；</b></p><p>　　異步通知商戶訂單系統(tǒng)交易結果；</p><p>　　2.2非標訂單支付（支付+通知模式）</p><p>　　a.當面付支付付款（主掃）時序圖及流程如下</p><p>　　消費者用

10、app（微信/支付寶/手Q）掃描商戶當面付二維碼，打開支付h5頁面；</p><p>　　消費者在h5頁面輸入備注信息及支付金額，并確認提交支付；</p><p>　　當面付H5上送訂單交易至交易核心進行處理，并實時返回結果；</p><p>　　交易核心異步將交易結果通知商戶系統(tǒng)</p><p>　　b.當面付支付收款（被掃）時序圖及流程如

11、下</p><p>　　商戶用收銀寶公眾號的收款功能輸入交易備注（可以不輸入）；</p><p>　　商戶輸入交易金額，點擊“去掃碼”調起掃一掃；</p><p>　　掃描消費者付款碼，進行當面付支付；</p><p><b>　　后臺返回交易結果；</b></p><p>　　異步通知商戶訂單系

12、統(tǒng)交易結果。</p><p><b>　　2.3.當面付撤銷</b></p><p>　　商戶在微信端/商服平臺／商戶系統(tǒng)（通過接口）用訂單號查詢交易；</p><p>　　平臺返回交易金額及詳情，商戶確認并提交撤銷交易；</p><p>　　當面付提交交易核心處理交易，并實時返回結果；</p><p

13、>　　交易核心異步將成功結果通知到商戶系統(tǒng)。</p><p>　　3當面付訂單模式設置</p><p>　　登陸https://vsp.allinpay.com；</p><p>　　B.點擊服務中心-》更多服務；</p><p>　　C.下拉頁面到底部，點擊當面付配置-》管理；</p><p>　　D.選擇并點

14、擊訂單模式；</p><p><b>　　(2.1模式）</b></p><p><b>　?。?.2模式）</b></p><p>　　E.2.1模式配置下，根據(jù)商戶行業(yè)需要，自行更改標題名稱，默認為訂單號，然后點擊保存；</p><p>　　F.提交商戶訂單系統(tǒng)的查詢URL及交易結果通知URL給

15、到通聯(lián)相關同事進行系統(tǒng)參數(shù)配置。該URL配置后續(xù)會開放到商戶服務平臺由商戶自行配置。</p><p>　　4當面付訂單模式場景示例圖</p><p>　　2.1模式下的交易示例：</p><p>　　A.商戶通過公眾號收款按鈕進入的界面。</p><p><b>　?。▓D4.1）</b></p><p

16、>　　B.消費者通過掃描當面付二維碼進入的付款界面;</p><p><b>　?。▓D4.2）</b></p><p><b>　　C.訂單查詢結果;</b></p><p><b>　　（圖4.3）</b></p><p>　　2.2模式下的交易示例</p>

17、<p>　　5當面付訂單查詢結果個性化</p><p><b>　　5.1前言</b></p><p>　　不同行業(yè)、不同商戶對訂單查詢結果顯示均會存在個性化需求，如4的訂單查詢結果顯示了6個字段，收費類型、訂單人姓名、訂購人地址、聯(lián)系電話、證件類型、證件號。但是有些商戶可能要減少這些顯示內容，或者增加一些不同的顯示內容，具體處理流程如下。</p&

18、gt;<p>　　5.2訂單詳情個性化</p><p>　　接口文檔的訂單查詢，商戶需要返回一個業(yè)務詳情字段：trxreserve，這個字段的描述如下</p><p>　　響應格式如上，為：業(yè)務類型(05)|Q1#內容|Q2#內容|Q3#內容，其中Q1，Q2，Q3為訂單詳情標簽，目前系統(tǒng)暫定的標準標簽如下：</p><p>　　如商家訂單系統(tǒng)響應的tr

19、xreserve內容格式為：05|Q1#張三|Q2:#186-2828-9999|Q3#廣州市天河區(qū)體育西路107號，則訂單查詢回來的內容圖片如下顯示：</p><p><b>　?。▓D5.2）</b></p><p>　　標簽順序按照trxreserve業(yè)務詳情內容順序展示，如順序是#Q1|#Q3|#Q2,圖5.2顯示內容從上到下是：訂購人姓名、聯(lián)系電話、地址。&l

20、t;/p><p>　　如果有部分備注信息不需要顯示在圖5.2，則可以通過下面的格式回傳：</p><p>　　05|Q1#張三|Q2:#186-2828-9999|Q3#廣州市天河區(qū)體育西路107號|X#不顯示但需保存到對賬單的內容</p><p>　　上面的格式內容，在訂單詳情顯示方面，與圖5.2一模一樣，但是后面的“不顯示但需保存到對賬單的內容”則會保存到交易明細及

21、對賬單備注中。</p><p><b>　　5.3標簽詳述</b></p><p>　　訂單詳情中的標簽暫時系統(tǒng)定義了從Q1-Q6 及B1-B6這12個標簽，如有其他行業(yè)有標準化或者商戶對接有個性化標簽需求，可提交到產品部進行維護</p><p><b>　　6開發(fā)對接步驟</b></p><p>

22、<b>　　6.1開發(fā)測試</b></p><p>　　a)商戶獲取接口文檔及demo</p><p>　　首先請下載最新的文檔和demo. </p><p>　　demo（內含接口規(guī)范文檔）下載地址： http://113.108.182.3:10080/apivalid/order/notify.htm</p><p&

23、gt;　　b)商戶開發(fā)并在線聯(lián)調</p><p>　　開發(fā)人員根據(jù)文檔和demo進行開發(fā),開發(fā)過程中可使用在線開發(fā)聯(lián)調工具進行參數(shù)校驗</p><p>　　聯(lián)調地址: http://113.108.182.3:10080/apivalid/order/notify.htm</p><p>　　c)商戶配置系統(tǒng)對接參數(shù)</p><p>　　1)

24、商戶配置appid和appkey</p><p>　　商戶向通聯(lián)索取測試環(huán)境的商戶號，登錄商服平臺，以便配置appid和appkey。</p><p>　　交易密鑰(appkey)：設置改密鑰前，需到“設置－安全”配置“交易密碼”；設置成功后如需修改，可點擊“重置” </p><p>　　appid：會隨著“交易密鑰”的配置自動生成。</p><

25、p>　　具體配置也可參閱收銀寶的商服平臺操作手冊</p><p>　　登錄名:商戶號+04</p><p><b>　　初始密碼：商戶號</b></p><p>　　商服平臺地址：http://113.108.182.3:10080/vsppcusweb/login</p><p>　　第一次登錄將提示修改密碼：點

26、擊【發(fā)送驗證碼】，輸入驗證碼111111，測試環(huán)境的驗證碼都是6個1，生產環(huán)境需輸入發(fā)送到手機的驗證碼。</p><p>　　修改新密碼成功，系統(tǒng)要求重新登錄，以新密碼登錄后，點擊【設置】，進入【安全】的交易密碼設置,設置交易密碼時的驗證碼為111111，生產環(huán)境需輸入發(fā)送到手機的驗證碼。</p><p>　　設置appid、appkey</p><p>　　進入【

27、服務中心】的【更多服務】</p><p>　　輸入商戶需要的交易密鑰（appkey），如果是集團商戶的子商戶，請輸入公用的appkey</p><p>　　點擊【顯示參數(shù)】，可獲取到appid和appkey</p><p>　　2)商戶設置當面付訂單模式</p><p>　　下拉到更多服務的頁面底部，點擊當面付配置-》管理；</p>

28、;<p><b>　　點擊【訂單模式】；</b></p><p>　　如果是3.1標準訂單支付模式，需打開“是否需求訂單查詢”,商戶可根據(jù)需要，自行更改標題名稱，默認為訂單號，然后點擊保存</p><p>　　如果是3.2非標準訂單支付模式，需關閉“是否需求訂單查詢”</p><p>　　3)商戶設置訂單對接的查詢url和通知ur

29、l</p><p>　　d) 商戶配置好相關測試參數(shù)后，進行測試</p><p>　　測試環(huán)境的收銀寶微商公眾號</p><p>　　當面付訂單模式場景示例圖</p><p>　　3.1標準訂單支付模式下的交易示例：</p><p>　　A.商戶通過微信掃描并綁定收銀寶微商公眾號，通過公眾號【收款】按鈕進入收款界面。&

30、lt;/p><p>　　B.消費者通過掃描當面付二維碼進入的付款界面;</p><p><b>　　C.訂單查詢結果;</b></p><p>　　3.2非標準訂單支付模式下的交易示例</p><p><b>　　6.2上線</b></p><p>　　1)分公司提供商戶正式生產