微信支付于2019年8月26日對微信支付分產(chǎn)品進(jìn)行了迭代升級，相關(guān)API接口也進(jìn)行了收斂升級，旨在提升用戶體驗(yàn)，方便商戶前期接入與后期統(tǒng)一維護(hù)。微信支付分后續(xù)開發(fā)的新功能都將僅支持新接口的調(diào)用，老接口也將于2020年12月15日停止維護(hù)。
新接口不再區(qū)分智慧零售、先享后付、免押租借、免押速住這四種模式，而是統(tǒng)一分為【免確認(rèn)模式】和【需確認(rèn)模式】接口，原有的免押租借、免押速住和大部分先享后付接口均為【需確認(rèn)模式】接口，智慧零售默認(rèn)為【免確認(rèn)模式】接口。【免確認(rèn)模式】是特殊接口方案，目前僅智慧零售、網(wǎng)約車、路邊停車、共享單車/電單車等行業(yè)可申請使用。
接入支付分的主要接口，請使用公共API目錄下的創(chuàng)建支付分訂單、查詢支付分訂單、完結(jié)支付分訂單等接口，具體填參請參照API文檔填寫。其中，【免確認(rèn)模式】、【需確認(rèn)模式】均使用公共API下的接口，只有確認(rèn)訂單拉起、授權(quán)服務(wù)查詢等才使用不同的接口。
1）新接口的確認(rèn)訂單回調(diào)地址和支付成功回調(diào)地址，不再使用后臺配置的方式，在創(chuàng)建訂單環(huán)節(jié)以參數(shù)的形式填入，參見創(chuàng)單接口的notify_url字段。
2）開啟服務(wù)回調(diào)地址，還是在后臺配置，申請入駐支付分時填寫。可聯(lián)系對接的業(yè)務(wù)人員做修改調(diào)整。
3）解密優(yōu)化：如果商戶當(dāng)前解密回調(diào)內(nèi)容是輪詢用商戶號解密，可以用新的創(chuàng)單接口，在創(chuàng)單時指定不同的回調(diào)地址，從而用不同的商戶號解密。對于開啟服務(wù)回調(diào)地址，則可以在不同的商戶號下配置不同的回調(diào)地址，區(qū)分不同商戶號下開通的支付分。
1）老接口和新接口的支付分訂單狀態(tài)不一致，商戶升級接口需要注意按照新文檔的支付分訂單狀態(tài)開發(fā)
2）接口根據(jù)訂單狀態(tài)有調(diào)用前提，老接口和新接口調(diào)用前提不一致，具體參看支付分新文檔
支付分的訂單狀態(tài)在如下：
| 正常訂單狀態(tài)流： | CREATED--->DOING(USER_COMFIRM)--->DOING(MCH_COMPLETE)--->DONE |
|---|
| 訂單狀態(tài) | 訂單狀態(tài)說明 | 說明 |
|---|---|---|
| CREATED：已創(chuàng)建服務(wù)訂單 | / | 指商戶調(diào)用創(chuàng)建訂單接口成功后的訂單狀態(tài) |
DOING：服務(wù)訂單進(jìn)行中 |
USER_COMFIRM：用戶確認(rèn) | 指用戶在支付分頁面上確認(rèn)訂單成功后的訂單狀態(tài)或（免確認(rèn)訂單模式下，創(chuàng)建訂單成功后時的訂單狀態(tài)） |
| MCH_COMPLETE：商戶完結(jié) | 指商戶調(diào)用完結(jié)訂單接口成功后的訂單狀態(tài) | |
| DONE：服務(wù)訂單完成 | / | 指從用戶側(cè)扣款成功 （微信支付分代扣成功，且非0元訂單）時的訂單狀態(tài) 或 調(diào)完結(jié)訂單接口并且扣款金額為0元時 （0元結(jié)單）的訂單狀態(tài) 或 商戶調(diào)用訂單信息同步接口成功時的訂單狀態(tài) |
| REVOKED：商戶取消服務(wù)訂單 | / | 指商戶調(diào)用取消訂單接口成功后的訂單狀態(tài) |
| EXPIRED：服務(wù)訂單已失效 | / | 指"商戶已創(chuàng)建服務(wù)訂單"狀態(tài)超過30天未變動，則訂單失效。 |
| 訂單狀態(tài) | 訂單狀態(tài)說明 | 收款渠道 | 說明 |
|---|---|---|---|
| USER_PAYING：待支付 | DOINE-(MCH_COMPLETE) | / | 指未扣款成功 |
| USER_PAID：已支付 | DONE | NEWTON：微信支付分 | 指從用戶側(cè)扣款成功 （微信支付分代扣成功） |
| MCH：商戶渠道 | 指商戶調(diào)用訂單信息同步接口成功（商戶通過其他方式收到錢了，用此接口通知微信支付分停止輪詢） |
| 回調(diào)類型 | 回調(diào)觸發(fā)機(jī)制 | 觸發(fā)時間 | 說明 |
|---|---|---|---|
| 確認(rèn)訂單回調(diào)通知 | 當(dāng)訂單主狀態(tài)為：【DOING：服務(wù)訂單進(jìn)行中】 子狀態(tài)為：【USER_CONFIRM：用戶確認(rèn)】時 |
立即 | 需確認(rèn)訂單流程：用戶點(diǎn)擊支付分頁面確認(rèn)訂單按鈕后 免確認(rèn)訂單流程：商戶創(chuàng)建訂單成功且用戶通過本次訂單風(fēng)險評估后 |
| 支付成功回調(diào)通知 | 當(dāng)訂單主狀態(tài)為：【DONE：服務(wù)訂單完成】 子狀態(tài)為：【USER_PAID：已支付】時 |
立即 | 需確認(rèn)訂單流程：商戶調(diào)用完結(jié)發(fā)起扣款且用戶支付成功后 免確認(rèn)訂單流程：商戶調(diào)用完結(jié)發(fā)起扣款且用戶支付成功后 |
| 授權(quán)/解除授權(quán)服務(wù)回調(diào)通知 | 當(dāng)用戶授權(quán)狀態(tài) 【UNAVAILABLE：用戶未授權(quán)服務(wù)】 【AVAILABLE：用戶已授權(quán)服務(wù)】發(fā)生轉(zhuǎn)變時 |
立即 | / |
原有以智慧零售、先享后付模式接入支付分的商戶，請確認(rèn)驗(yàn)簽方式是否已升級為v3模式，如無，請升級。原有以免押租借、免押速住模式接入支付分的商戶，請按如下指引升級為《微信支付v3驗(yàn)簽方式 》
原有智慧零售、先享后付、免押租借、免押速住模式請確認(rèn)是否設(shè)置了apiv3密鑰，如無，請按如下指引設(shè)置apiv3密鑰設(shè)置指引：《APIv3密鑰設(shè)置》
原有智慧零售、先享后付、免押租借、免押速住模式請確認(rèn)原有api密鑰是否正確，如丟失，可以按如下指引重置api密鑰設(shè)置指引：《APIv2密鑰設(shè)置》
1）新老接口不可混用。使用新接口創(chuàng)建的訂單，查詢、完結(jié)等接口也需要使用新的接口；老接口生成的訂單，也只能用老接口進(jìn)行查詢、完結(jié)等操作。（接入新接口后，商戶需要保留一段時間老接口，以便對老接口生成的訂單進(jìn)行處理。）
2）免確認(rèn)模式特有API下的創(chuàng)單結(jié)單合并接口，暫未對外開放，如有需要請咨詢對接的業(yè)務(wù)人員，申請開通調(diào)用權(quán)限。適用于無需微信支付分做訂單風(fēng)控判斷的業(yè)務(wù)場景，在服務(wù)完成后，通過該接口對用戶進(jìn)行免密代扣。