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

1、支付寶（當(dāng)面付）解決方案版本號(hào)：2.0支付寶（中國）網(wǎng)絡(luò)技術(shù)有限公司 版權(quán)所有支付寶（當(dāng)面付）解決方案目 錄1 商戶背景22 業(yè)務(wù)流程32.1 完整交易流程32.1.1 條碼支付（終端掃用戶）32.1.2 掃碼支付（用戶掃終端）52.1.3 退款82.1.4 單邊賬、沖正103 集成113.1 對(duì)賬113.2 開發(fā)語言113.3 項(xiàng)目排期113.4 其他規(guī)范114 測(cè)試121 商戶背景2 業(yè)務(wù)流程2.1 完整交易流程2.1.1 條碼支付（終端掃用戶）流程說明：以上流程需要用到的接口：1、 統(tǒng)一下單并支付接口(alipay.acquire.createandpay)a) 下單接口中訂單支付超時(shí)時(shí)

2、間（it_b_pay）請(qǐng)?jiān)O(shè)置為1分鐘。b) 在提交下單接口后觸發(fā)輪詢支付寶查詢接口邏輯，間隔為5秒鐘，若超時(shí)用戶未付款，則由前置機(jī)發(fā)起撤銷動(dòng)作，在撤銷前，前置機(jī)必須最后做一次查詢操作，防止終端最后一次查詢和前置機(jī)撤銷之間有延時(shí)，導(dǎo)致把用戶已支付的交易撤銷了。c) 收到支付寶回傳的數(shù)據(jù)必須做驗(yàn)簽，個(gè)別參數(shù)例如fund_bill_list，正確的拼裝格式是不解析內(nèi)部xml節(jié)點(diǎn)，直接key value，示例如：&fund_bill_list=<fund_bill_list><TradeFundBill><amount>0.01</amount>

3、<fund_channel>10</fund_channel></TradeFundBill></fund_bill_list>&d) 業(yè)務(wù)擴(kuò)展參數(shù)中的門店ID、終端編號(hào)ID、Agent_ID必須傳入 2、 收單查詢接口(alipay.acquire.query)在調(diào)用下單接口之后如果未能立即返回支付成功，則間隔5秒輪詢?cè)摻涌?，直到收到用戶已付款的狀態(tài)為止，最長輪詢時(shí)間建議1分鐘3、 收單撤銷接口(alipay.acquire.cancel)當(dāng)查詢一分鐘還未能收到已支付的結(jié)果，則調(diào)用該接口關(guān)閉此訂單。撤銷接口實(shí)現(xiàn)之后也必須讓商戶要有重試機(jī)

4、制，規(guī)范是5秒2次，直到該接口能夠同步響應(yīng)結(jié)果為止。2.1.2 掃碼支付（用戶掃終端）流程說明：以上流程需要用到的接口：1、 統(tǒng)一預(yù)下單接口(alipay.acquire.precreate)e) 預(yù)下單接口中訂單支付超時(shí)時(shí)間（it_b_pay）請(qǐng)?jiān)O(shè)置為2分鐘。f) 在提交預(yù)下單接口后觸發(fā)輪詢支付寶查詢接口邏輯，間隔為5秒鐘，若此時(shí)用戶未掃碼，會(huì)返回交易不存在，若用戶掃碼會(huì)返回等待買家付款狀態(tài)，若超過2分鐘用戶未付款，則由前置機(jī)發(fā)起撤銷動(dòng)作，在撤銷前，前置機(jī)必須最后做一次查詢操作，防止終端最后一次查詢和前置機(jī)撤銷之間有延時(shí)，導(dǎo)致把用戶已支付的交易撤銷了。g) 收到支付寶回傳的數(shù)據(jù)必須做驗(yàn)簽，個(gè)

5、別參數(shù)例如fund_bill_list，正確的拼裝格式是不解析內(nèi)部xml節(jié)點(diǎn)，直接key value，示例如：&fund_bill_list=<fund_bill_list><TradeFundBill><amount>0.01</amount><fund_channel>10</fund_channel></TradeFundBill></fund_bill_list>&h) 業(yè)務(wù)擴(kuò)展參數(shù)中的門店ID、終端編號(hào)ID、Agent_ID必須傳入 2、 收單查詢接口(alipay.acq

6、uire.query)在調(diào)用下單接口之后如果未能立即返回支付成功，則間隔5秒輪詢?cè)摻涌?，直到收到用戶已付款的狀態(tài)為止，最長輪詢時(shí)間建議2分鐘3、 收單撤銷接口(alipay.acquire.cancel)當(dāng)查詢一分鐘還未能收到已支付的結(jié)果，則調(diào)用該接口關(guān)閉此訂單。撤銷接口實(shí)現(xiàn)之后也必須讓商戶要有重試機(jī)制，規(guī)范是5秒2次，直到該接口能夠同步響應(yīng)結(jié)果為止。2.1.3 退款流程說明：以上流程需要用到的接口：1、 收單退款接口(alipay.acquire.refund)a) 退款接口支持全額退款和部分退款。b) 退款金額不能超過原始訂單的交易總金額。c) 退款到用戶是原路返回，用戶如果使用銀行卡快捷

7、，就會(huì)直接返回到銀行卡，根據(jù)銀行到賬時(shí)間T+N。d) 如果退款發(fā)生失敗，并且商戶發(fā)起的支付寶賬號(hào)是有余額能夠支付退款的，則重試2次退款，還是不行就人工介入，可以聯(lián)系支付寶服務(wù)支持或技術(shù)支持解決。2.1.4 單邊賬、沖正流程說明：以上流程需要用到的接口：1、 收單撤銷接口(alipay.acquire.cancel)a) 撤銷接口正常調(diào)用都是返回成功狀態(tài)，所以要判斷參數(shù)是否有資金變動(dòng)，如果有資金變動(dòng)則認(rèn)為是撤銷交易成功，無資金變動(dòng)表示該交易不存在或者已經(jīng)被關(guān)閉了。b) 如果返回結(jié)果報(bào)錯(cuò)，可以重試，如果重試2次還是報(bào)錯(cuò)，人工介入，聯(lián)系支付寶。3 集成3.1 對(duì)賬商戶如果是直接與支付寶簽約，可以由B

8、D開通對(duì)賬接口，如果是渠道商直接簽約的下家，是不能申請(qǐng)對(duì)賬接口的。3.2 開發(fā)語言3.3 項(xiàng)目排期3.4 其他規(guī)范1、 系統(tǒng)交互模塊需要商戶做必要的容錯(cuò)，系統(tǒng)一定要健壯，不能因?yàn)橹Ц秾毟膭?dòng)了任何一個(gè)參數(shù)就系統(tǒng)奔潰或者影響用戶能夠正常完成的交易2、 必須做災(zāi)備機(jī)制，有一個(gè)備用服務(wù)器3、 小票必須帶有支付寶的交易號(hào)或者商戶的訂單號(hào)，必須有優(yōu)惠金額等信息4、 日志：POS端日志：把提交參數(shù) xml記下來，考慮日志大小及時(shí)清理服務(wù)端日志：記錄POS收到的時(shí)間和 返回時(shí)間；當(dāng)發(fā)生錯(cuò)誤及異常的情況下，必須對(duì)該訂單做詳細(xì)的記錄，以便雙方技術(shù)人員事后排查并解決。5、 個(gè)性化：查詢的輪詢工作放在終端平板上實(shí)現(xiàn)，減少前置機(jī)的輪詢壓力，最后一次查詢是放在前置機(jī)，未支付則調(diào)用撤