當(dāng)面付解決方案

Alipaycom支付寶（當(dāng)面付）解決方案版本號：2.0支付寶（中國）網(wǎng)絡(luò)技術(shù)有限公司版權(quán)所有目錄TOC\o"1-5"\h\z\o"CurrentDocument"1商戶背景2\o"CurrentDocument"2業(yè)務(wù)流程3\o"CurrentDocument"2.1完整交易流程32.1.1條碼支付（終端掃用戶）32.1.2掃碼支付（用戶掃終端）52.1.3退款82.1.4單邊賬、沖正10\o"CurrentDocument"3集成11\o"CurrentDocument"3.1對賬11\o"CurrentDocument"3.2開發(fā)語言11\o"CurrentDocument"3.3項(xiàng)目排期11\o"CurrentDocument"3.4其他規(guī)范11\o"CurrentDocument"4測試121商戶背景2業(yè)務(wù)流程2.1完整交易流程2.1.1條碼支付（終端掃用戶）流程說明:以上流程需要用到的接口：1、統(tǒng)一下單并支付接口（alipay.acquire.createandpay）a）下單接口中訂單支付超時時間（it_b_pay）請?jiān)O(shè)置為1分鐘。b）在提交下單接口后觸發(fā)輪詢支付寶查詢接口邏輯，間隔為5秒鐘，若超時用戶未付款，則由前置機(jī)發(fā)起撤銷動作，在撤銷前，前置機(jī)必須最后做一次查詢操作，防止終端最后一次查詢和前置機(jī)撤銷之間有延時，導(dǎo)致把用戶已支付的交易撤銷了。c）收到支付寶回傳的數(shù)據(jù)必須做驗(yàn)簽，個別參數(shù)例如fund_bill_list，正確的拼裝格式是不解析內(nèi)部xml節(jié)點(diǎn)，直接keyvalue，示例如：...&fund_bill_list=<fund_bill_list><TradeFundBill><amount>0.01</amount><fund_channel>10</fund_channel></TradeFundBill></fund_bill_list>&..d）業(yè)務(wù)擴(kuò)展參數(shù)中的門店ID、終端編號ID、Agent_ID必須傳入2、收單查詢接口（alipay.acquire.query）在調(diào)用下單接口之后如果未能立即返回支付成功，則間隔5秒輪詢該接口，直到收到用戶已付款的狀態(tài)為止，最長輪詢時間建議1分鐘3、收單撤銷接口（alipay.acquire.cancel）當(dāng)查詢一分鐘還未能收到已支付的結(jié)果，則調(diào)用該接口關(guān)閉此訂單。撤銷接口實(shí)現(xiàn)之后也必須讓商戶要有重試機(jī)制，規(guī)范是5秒2次，直到該接口能夠同步響應(yīng)結(jié)果為止。2.1.2掃碼支付（用戶掃終端）

流程說明：以上流程需要用到的接口：1、統(tǒng)一預(yù)下單接口(alipay.acquire.precreate)預(yù)下單接口中訂單支付超時時間(it_b_pay)請?jiān)O(shè)置為2分鐘。在提交預(yù)下單接口后觸發(fā)輪詢支付寶查詢接口邏輯，間隔為5秒鐘，若此時用戶未掃碼，會返回交易不存在，若用戶掃碼會返回等待買家付款狀態(tài)，若超過2分鐘用戶未付款，則由前置機(jī)發(fā)起撤銷動作，在撤銷前，前置機(jī)必須最后做一次查詢操作，防止終端最后一次查詢和前置機(jī)撤銷之間有延時，導(dǎo)致把用戶已支付的交易撤銷了。收到支付寶回傳的數(shù)據(jù)必須做驗(yàn)簽，個別參數(shù)例如fund_bill_list，正確的拼裝格式是不解析內(nèi)部xml節(jié)點(diǎn)，直接keyvalue，示例如：...&fund_bill_list=<fund_bill_list><TradeFundBill><amount>0.01</amount><fund_channel>10</fund_channel></TradeFundBill></fund_bill_list>&..業(yè)務(wù)擴(kuò)展參數(shù)中的門店ID、終端編號ID、Agent_ID必須傳入2、收單查詢接口(alipay.acquire.query)在調(diào)用下單接口之后如果未能立即返回支付成功，則間隔5秒輪詢該接口，直到收到用戶已付款的狀態(tài)為止，最長輪詢時間建議2分鐘3、收單撤銷接口(alipay.acquire.cancel)當(dāng)查詢一分鐘還未能收到已支付的結(jié)果，則調(diào)用該接口關(guān)閉此訂單。撤銷接口實(shí)現(xiàn)之后也必須讓商戶要有重試機(jī)制，規(guī)范是5秒2次，直到該接口能夠同步響應(yīng)結(jié)果為止。

流程說明：以上流程需要用到的接口：1、收單退款接口（alipay.acquire.refund）a）退款接口支持全額退款和部分退款。b）退款金額不能超過原始訂單的交易總金額。c）退款到用戶是原路返回，用戶如果使用銀行卡快捷，就會直接返回到銀行卡，根據(jù)銀行到賬時間T+N。d）如果退款發(fā)生失敗，并且商戶發(fā)起的支付寶賬號是有余額能夠支付退款的，則重試2次退款，還是不行就人工介入，可以聯(lián)系支付寶服務(wù)支持或技術(shù)支持解決。流程說明:以上流程需要用到的接口：1、收單撤銷接口(alipay.acquire.cancel)a）撤銷接口正常調(diào)用都是返回成功狀態(tài)，所以要判斷參數(shù)是否有資金變動，如果有資金變動則認(rèn)為是撤銷交易成功，無資金變動表示該交易不存在或者已經(jīng)被關(guān)閉了。b）如果返回結(jié)果報錯，可以重試，如果重試2次還是報錯，人工介入，聯(lián)系支付寶。3集成3.1對賬商戶如果是直接與支付寶簽約，可以由BD開通對賬接口，如果是渠道商直接簽約的下家，是不能申請對賬接口的。3.2開發(fā)語言3.3項(xiàng)目排期3.4其他規(guī)范1、系統(tǒng)交互模塊需要商戶做必要的容錯，系統(tǒng)一定要健壯，不能因?yàn)橹Ц秾毟膭恿巳魏我粋€參數(shù)就系統(tǒng)奔潰或者影響用戶能夠正常完成的交易2、必須做災(zāi)備機(jī)制，有一個備用服務(wù)器3、小票必須帶有支付寶的交易號或者商戶的訂單號，必須有優(yōu)惠金額等信息4、日志：POS端日志：把提交參數(shù)xml記下來，考慮日志大小及時清理月服務(wù)端日志：記錄POS收到的時間和返回時間；當(dāng)發(fā)生錯誤及異常的情況下，必須對該訂單做詳細(xì)的記錄，以便雙方技術(shù)人員事后排查并解決。5、個性化：查詢的輪詢