通聯(lián)收銀寶

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

2、lt;/p><p><b>　　2產(chǎn)品模式4</b></p><p>　　2.1標(biāo)準(zhǔn)訂單支付（查詢+支付+通知模式）4</p><p>　　a.當(dāng)面付支付付款（主掃）時(shí)序圖及流程如下：4</p><p>　　b.當(dāng)面付支付收款（被掃）時(shí)序圖及流程如下6</p><p>　　2.2非標(biāo)訂單支付（

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

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

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

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

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

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

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

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

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

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

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

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

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

16、>　　B.消費(fèi)者通過掃描當(dāng)面付二維碼進(jìn)入的付款界面;</p><p><b>　　（圖4.2）</b></p><p><b>　　C.訂單查詢結(jié)果;</b></p><p><b>　?。▓D4.3）</b></p><p>　　2.2模式下的交易示例</p>

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

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

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

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

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

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

23、gt;　　b)商戶開發(fā)并在線聯(lián)調(diào)</p><p>　　開發(fā)人員根據(jù)文檔和demo進(jìn)行開發(fā),開發(fā)過程中可使用在線開發(fā)聯(lián)調(diào)工具進(jìn)行參數(shù)校驗(yàn)</p><p>　　聯(lián)調(diào)地址: 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)：設(shè)置改密鑰前，需到“設(shè)置－安全”配置“交易密碼”；設(shè)置成功后如需修改，可點(diǎn)擊“重置” </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>　　第一次登錄將提示修改密碼：點(diǎn)

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

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

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

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

30、lt;/p><p>　　B.消費(fèi)者通過掃描當(dāng)面付二維碼進(jìn)入的付款界面;</p><p><b>　　C.訂單查詢結(jié)果;</b></p><p>　　3.2非標(biāo)準(zhǔn)訂單支付模式下的交易示例</p><p><b>　　6.2上線</b></p><p>　　1)分公司提供商戶正式生產(chǎn)