自定義交易組件
本文主要介紹新版自定義交易組件的業(yè)務(wù)流程及各流程的注意事項，文檔篇幅較長，如無需查看完整文檔可以使用瀏覽器自帶頁面搜索功能進行關(guān)鍵字搜索（快捷鍵Ctrl+F ）。
在開始開發(fā)前應(yīng)確認(rèn)以下必要前置條件是否完成：
1、開通場景經(jīng)營商戶號；
2、部分接口強制校驗來源IP白名單，白名單配置方式：
1）服務(wù)商配置方式"點我查看"
2）普通小程序：登錄小程序管理后臺->開發(fā)管理->開發(fā)設(shè)置->“開發(fā)者ID”下的“IP白名單”
3、因視頻號場景受控訂單無微信支付回調(diào)，支付結(jié)果等事件是通過小程序消息推送進行下發(fā)的，需要登錄小程序管理后臺后，在「開發(fā)」-「開發(fā)設(shè)置」-「消息推送」中啟用并設(shè)置消息推送配置，開發(fā)者接收到的消息需要解密， 消息加解密說明可在開發(fā)文檔查詢。
1、業(yè)務(wù)流程圖
1.1 關(guān)鍵流程邏輯
1.2 售后流程
1.3 主要業(yè)務(wù)變動
2、接入流程詳細(xì)說明
整體接入流程
注：本文2.1-2.2為前置必做流程，完成后才可以進行接口調(diào)試
2.1 開通自定義交易組件
2.1.1 公眾平臺后臺開通
登錄公眾平臺,點擊功能下方的“交易組件”，點擊“開通”閱讀并同意開通協(xié)議后即可進行下一步操作。
開通后頁面如圖所示
2.1.2 接口申請開通
調(diào)用接口 “shop/register/apply” 申請開通自定義版交易組件，請求成功后將發(fā)送“法務(wù)協(xié)議確認(rèn)”到管理員微信，管理員需要在“24小時內(nèi)”點擊該模板消息，并確認(rèn)服務(wù)協(xié)議。服務(wù)協(xié)議簽署成功后，開發(fā)者可以通過“獲取接入狀態(tài)接口（可點擊跳轉(zhuǎn)）”或“”事件回調(diào)“進行開通狀態(tài)判斷，若狀態(tài)為“已開通”，開發(fā)者才可以繼續(xù)調(diào)用后續(xù)接口進行調(diào)試接入。
2.1.3 自定義交易組件“升級版”跟升級前的自定義交易組件有什么區(qū)別，哪些接口需要進行升級？
1.新支付接口，必須走新商戶號。
2.取消訂單， 小程序(小程序內(nèi)以及發(fā)現(xiàn)-小程序我的訂單)和視頻號雙向可取消，之前只可以在小程序上取消，然后同步給視頻號狀態(tài)。
3.申請退款，小程序和視頻號雙向可申請退款。
4.申請退貨退款,小程序和視頻號雙向可申請退貨退款，之前只有小程序上操作。
5.未付款訂單，小程序和視頻號 可在各自訂單中心重新支付，同步狀態(tài)。
6.確認(rèn)收貨，小程序和視頻號雙向可確認(rèn)收貨。
7.同步發(fā)貨狀態(tài)接口更新。
2.2 開通場景經(jīng)營所需商戶號
視頻號場景下，會通過開通商戶號、補齊資料，獲得一個新的電商收付通的商戶號。商家在視頻號內(nèi)的交易資金流，需要使用這個新商戶號。
- 準(zhǔn)備事項：需準(zhǔn)備營業(yè)執(zhí)照、法人身份證、商戶號超級管理員手機號、郵箱信息
- 注意事項：小程序超管將作為微信支付商戶號的超級管理員，如管理員已離職、管理員曾變更過姓名未在小程序后臺更新等情況，將影響商戶號的簽約，請確認(rèn)無誤后再進行商戶號申請。
2.2.1 通過公眾平臺后臺申請
在小程序官方后臺自定義交易組件頁面，點擊商戶號申請所對應(yīng)的“去開通”按鈕進入商戶號申請頁面，共計三部分（不想開商戶號了，暫時不放圖）：
2.2.1.1 填寫基礎(chǔ)信息
此部分主要為上傳營業(yè)執(zhí)照、法人身份證、填寫商戶號超管信息
2.2.1.2驗證賬戶小額打款/法人驗證
此部分會有兩種情況，如為“小額打款”驗證方式，在頁面輸入收到的打款金額即可；如為法人驗證，需要使用實名認(rèn)證為法人同名微信掃碼進行驗證。
2.2.1.3確認(rèn)賬戶真實性。
點擊“去簽署”按鈕會展示簽約二維碼，使用超管微信進行掃碼，用于確認(rèn)經(jīng)營意愿并簽署協(xié)議，完成商戶號注冊。
2.2.2 通過API接口申請
調(diào)用“提交支付資質(zhì)”接口，提交場景經(jīng)營所需商戶號申請，提交成功后，商戶申請是沒有事件回調(diào)的，需要服務(wù)商主動調(diào)用“狀態(tài)查詢接口”查詢申請單進度，申請單狀態(tài)同“電商收付通二級商戶進件申請單狀態(tài)查詢”。此處不做過多描述，有問題可以留言，后續(xù)視情況補充更新。
2.2.3 開通場景經(jīng)營商戶常見問題
2.2.3.1 Q：新版交易組件需要重新申請商戶號嗎？是否可以使用原有商戶號？
A：不可以，新版交易組件必須要申請開通場景專用商戶號
2.2.3.2 Q:新版場景專用商戶號費率是多少，是否有優(yōu)惠，結(jié)算周期是多久？
A：商戶號費率為0.6%，無費率優(yōu)惠，結(jié)算周期為7+7日，即用戶收貨后7天后結(jié)算。
2.2.3.3 Q：申請新商戶號時，最后一步簽約遇到“微信實名信息與管理員信息不一致”是什么原因？
A：申請新的場景專用商戶號時，“超級管理員”這一項不支持修改，默認(rèn)為小程序“超級管理員”實名信息，如需修改，需要為該用戶前往成員管理為小程序綁定超級管理員。
2.2.3.4 Q：申請新的商戶號時，為什么不能修改主體信息?
A：“當(dāng)前主體”這一項不支持修改，因為商戶號主體必須和該小程序注冊主體保持一致。
2.2.3.5 Q：通過新版自定義交易組件申請的場景專用商戶號是否對跨境類小程序（自助報關(guān)）有影響？
A：會，二級商戶當(dāng)前暫不支持自助清關(guān)接口調(diào)用，留意后續(xù)更新通知
2.2.3.6 Q：新商戶號是否支持分賬功能？
A：即將支持，敬請期待。
2.3 上傳商品并通過審核，完成商品接口調(diào)用（僅有API接入方式）
基礎(chǔ)流程，不做過多說明，只寫流程、常見錯誤和注意事項
2.3.1 添加商品流程：
（1）首先去“獲取類目詳情”，與自己的系統(tǒng)商品類目相匹配
（2）查看對應(yīng)類目是否需要行業(yè)資質(zhì)，如果需要，請上傳相關(guān)資質(zhì)
（3）“上傳相關(guān)類目資質(zhì)”獲得對應(yīng)類目的使用權(quán)限
（4）如果商品有品牌，“上傳品牌信息”獲得品牌的使用權(quán)限
（5）調(diào)用“添加商品”接口將商品進行上傳
2.3.2 SPU接口常見錯誤及注意事項
2.3.2.1 Q：自定義交易組件提交上傳類目資質(zhì)時報錯{“errcode”: 1000009, “errmsg”: “調(diào)用的類目id不存在”}
A: 調(diào)用獲取類目詳情，看對應(yīng)““qualification_type"與"product_qualification_type"參數(shù)是否為"0”，為"0"無需上傳類目資質(zhì)
2.3.2.2 Q：調(diào)用自定義交易組件“添加商品”接口shop/spu/add時報錯“該賬號客服方式必須包含微信客服/小程序客服” {“errcode”:1040042,“errmsg”:"該賬號客服方式必須包含微信客服/小程序客服”}
A11:需要在MP后臺配置微信客服/小程序客服后，然后通過“更新商家信息”接口更新商家信息
調(diào)用“獲取商家信息”接口應(yīng)返回一下內(nèi)容才為成功，“service_agent_type”字段需要同時包含0，1，2三個值
2.3.2.3 Q：類目審核成功，但是添加商品報錯，{“errcode”:1000005,“errmsg”:"該商品使用了未申請通過的類目，請先申請類目且通過后再提審商品 "}
A: 檢查是否取消開通過，取消開通會清空品牌類目。對于服務(wù)商，可以監(jiān)聽賬戶接入回調(diào)事件，目前只有取消開通回調(diào)。
2.3.2.4 Q：調(diào)用自定義組件上傳圖片接口報錯{“errcode”:1070001,“errmsg”:"文件/圖片為空 "}
A25:檢查請求報文協(xié)議，需Content-Type: multipart/form-data
2.4 調(diào)試支付校驗，完成訂單接口調(diào)用
2.4.1 支付流程：
（1）按照"開發(fā)指引"修改基礎(chǔ)庫配置
（2）在小程序中調(diào)用"生成訂單"接口生成一筆訂單
（3）完成訂單的支付（視頻號場景需要調(diào)用生成支付參數(shù)后完成收銀臺的拉起，其他場景按照已有業(yè)務(wù)邏輯進行支付）
（4）調(diào)用"同步訂單支付結(jié)果"接口同步訂單的支付結(jié)果（二級商戶單無需同步支付結(jié)果，系統(tǒng)自動流轉(zhuǎn)訂單狀態(tài)）
注意：
- 這里兩個接口都需要調(diào)用，以同步訂單結(jié)果為最后確認(rèn)步驟，視頻號場景則以支付成功作為最終確認(rèn)步驟。
- 基礎(chǔ)庫拉起收銀臺接口改造后需要發(fā)版才可以生效。
- 完成接口調(diào)用后，點擊完成，切換狀態(tài)。
2.4.2 訂單接口接口常見錯誤及注意事項
2.4.2.1 Q：二級商戶號訂單支付流程與原有訂單支付流程有什么區(qū)別？
A17:主要區(qū)別是：二級商戶號訂單調(diào)起支付所需參數(shù)是通過“生成支付參數(shù)”獲取，無需同步支付結(jié)果；原流程調(diào)起支付是需要通過微信支付統(tǒng)一下單獲取，需要同步支付結(jié)果。
2.4.2.2 Q：調(diào)用自定義交易組件“創(chuàng)建訂單”接口shop/order/add時報錯“不支持的發(fā)貨方式” {“errcode”:1010036,“errmsg”:"不支持的發(fā)貨方式“}
A：視頻號場景當(dāng)前只支持“正?？爝f”方式，其他請留意后續(xù)更新。
2.4.2.3 Q：自定義交易組件申請視頻號專用商戶號后，喚起支付報錯: “商戶號該產(chǎn)品權(quán)限未開通”
A:需要先調(diào)用“生成訂單”接口，生成訂單時將fund_type設(shè)為1，然后調(diào)用“生成支付參數(shù)”接口獲取調(diào)取支付所需參數(shù)，不要調(diào)用微信支付統(tǒng)一下單接口獲取調(diào)用支付參數(shù)
2.4.2.4 Q：自定義交易組件二級商戶單調(diào)起支付時報錯“JSAPI缺少參數(shù)total_fee”
A:生成支付參數(shù)失敗，沒返回正確的預(yù)支付 ID，重新調(diào)用生成支付參數(shù)接口獲取新的支付參數(shù)即可
2.4.2.5 Q：自定義交易組件調(diào)用同步訂單支付結(jié)果時報錯 {“errcode”:990022,“errmsg”:"暫不支持操作“}
A：二級商戶單無需同步支付結(jié)果，付款成功后系統(tǒng)自動流轉(zhuǎn)訂單狀態(tài)并下發(fā)支付結(jié)果回調(diào)事件。
2.5 調(diào)試發(fā)貨接口，完成物流相關(guān)接口調(diào)用
2.5.1 發(fā)貨流程
（1）先調(diào)用獲取快遞公司列表接口獲取快遞公司信息
（2）調(diào)用"訂單發(fā)貨"接口，完成發(fā)貨
2.5.2 發(fā)貨接口常見錯誤及注意事項
注意事項：
- 視頻號訂單狀態(tài)流轉(zhuǎn)不可逆的，當(dāng)finish_all_delivery=0時，訂單狀態(tài)流轉(zhuǎn)到21（部分發(fā)貨）， 當(dāng)finish_all_delivery=1時，訂單狀態(tài)從20（待發(fā)貨）/ 21(部分發(fā)貨）流轉(zhuǎn)到30（待收貨），部分發(fā)貨時finish_all_delivery一定要傳0，最后一次發(fā)貨才可以傳1，切記！切記！切記?。?！
2.5.2.1 Q：調(diào)用自定義交易組件“創(chuàng)建訂單”接口shop/order/add時報錯“不支持的發(fā)貨方式” {“errcode”:1010036,“errmsg”:"不支持的發(fā)貨方式“}
A：視頻號場景當(dāng)前只支持“正常快遞”方式，其他請留意后續(xù)更新。
2.5.2.2 Q：當(dāng)自定義交易組件訂單只存在一個SKU，發(fā)貨時誤操作為部分發(fā)貨，訂單狀態(tài)碼流轉(zhuǎn)為21時，在既不能確認(rèn)收貨、也不能退款的情況下應(yīng)該如何處理？
A：按照截圖示例傳參，即可完成發(fā)貨，訂單狀態(tài)由21轉(zhuǎn)為30，訂單狀態(tài)變更后就可以正常流轉(zhuǎn)
注：傳參時order_id與out_order_id二選一傳參
2.6 調(diào)試售后接口，完成售后接口調(diào)用
2.6.1 售后流程、超時時間及售后事件和API、回調(diào)的對應(yīng)關(guān)系
看本文1.2 售后流程圖
用戶及商戶處理售后超時時間
| 類型 | 超時時間 |
|---|---|
| 商家處理退款超時 | 48小時 |
| 商家處理退貨超時 | 48小時 |
| 用戶超時未申請平臺接入 | 7天 |
| 用戶上傳退貨物流超時 | 7天 |
| 商家超時未確認(rèn)收貨 | 10天 |
售后事件和API、回調(diào)的對應(yīng)關(guān)系
| 事件 | API | 觸發(fā)回調(diào) | 說明 |
|---|---|---|---|
| 用戶申請退款 | 用戶提交售后申請 | 用戶提交售后申請回調(diào) | - |
| 用戶申請退貨 | 用戶提交售后申請 | 用戶提交售后申請回調(diào) | - |
| 用戶修改申請 | 用戶更新售后申請 | 用戶更新售后申請回調(diào) | - |
| 用戶取消申請 | 用戶取消售后申請 | 用戶取消售后申請回調(diào) | - |
| 用戶申請平臺介入 | 無API，只能由用戶在微信側(cè)觸發(fā) | 暫無 | - |
| 用戶超時未申請平臺介入（7天） | - | 用戶申請平臺介入超時回調(diào) | - |
| 用戶上傳退貨物流 | 用戶上傳物流信息 | 用戶上傳退貨物流回調(diào)(待商家確認(rèn)收貨) | - |
| 用戶超時未上傳退貨物流（7天） | - | 用戶上傳退貨物流超時回調(diào) | - |
| 用戶確認(rèn)退款憑證 | 無API，只能由用戶在微信側(cè)觸發(fā) | 用戶確認(rèn)退款憑證回調(diào) | - |
| 商家同意退款 | 同意退款 | - | - |
| 商家處理退款超時（48小時） | - | 商家處理退款請求超時回調(diào) | - |
| 商家同意退貨 | 同意退貨 | - | - |
| 商家處理退貨超時（48小時） | - | 商家處理退貨申請超時回調(diào) | - |
| 商家拒絕退款 | 拒絕售后 | - | - |
| 商家拒絕退貨 | 拒絕售后 | - | - |
| 商家上傳退款憑證 | 上傳退款憑證 | - | |
| 商家確認(rèn)收貨 | 同意退款 | 商家確認(rèn)收到的貨沒問題后，調(diào)用同意退款A(yù)PI表示確認(rèn)收貨，如果有問題就調(diào)用拒絕售后API | |
| 商家超時未確認(rèn)收貨（10天） | - | 商家確認(rèn)收貨超時回調(diào) | - |
| 平臺退款成功 | - | 平臺退款成功回調(diào) | - |
| 平臺退款失敗 | - | 平臺退款失敗回調(diào)(待商家線下退款) | - |
| 平臺判定用戶責(zé)任 | - | 糾紛事件更新售后單狀態(tài)回調(diào) | 糾紛事件通知請見糾紛回調(diào) |
| 平臺判定商家退款 | - | 糾紛事件更新售后單狀態(tài)回調(diào) | 糾紛事件通知請見糾紛回調(diào) |
| 平臺判定商家退貨 | - | 糾紛事件更新售后單狀態(tài)回調(diào) | 糾紛事件通知請見糾紛回調(diào) |
2.6.2 售后接口常見錯誤及注意事項
注意事項
- 新舊接口不可混用，新售后接口無法處理舊接口訂單，否則會出現(xiàn)很多意想不到的錯誤
2.6.2.1 枚舉值定義
（1）AfterSalesReason
| 枚舉值 | 描述 |
|---|---|
| 1 | 排錯/多拍 |
| 2 | 不想要了 |
| 3 | 無快遞信息 |
| 4 | 包裹為空 |
| 5 | 已拒簽包裹 |
| 6 | 快遞長時間未送達 |
| 7 | 與商品描述不符 |
| 8 | 質(zhì)量問題 |
| 9 | 賣家發(fā)錯貨 |
| 10 | 三無產(chǎn)品 |
| 11 | 假冒產(chǎn)品 |
| 12 | 其他 |
（2）AfterSalesState
| 枚舉值 | 描述 |
|---|---|
| 1 | 用戶取消 |
| 2 | 商家受理退款申請中 |
| 4 | 商家拒絕退款 |
| 5 | 商家拒絕退貨退款 |
| 6 | 待買家退貨 |
| 7 | 售后單關(guān)閉 |
| 8 | 待商家收貨 |
| 11 | 平臺退款中 |
| 13 | 退款成功 |
| 21 | 平臺受理退款申請中 |
| 22 | 平臺介入處理完成 |
| 23 | 商家受理退貨申請中 |
| 24 | 平臺受理退貨申請中 |
2.6.2.2 Q：調(diào)用自定義交易組件售后相關(guān)接口：“創(chuàng)建售后單”、“用戶取消售后單”、“用戶上傳物流信息”、“獲取售后單列表”、“獲取售后單詳情”、“同意退款“、”同意退貨“、“拒絕售后”、“上傳退款憑證”、“更新售后單”等接口時報錯{“errcode”: 48001,“errmsg”: “api unauthorized”}
A18:未開通視頻號場景經(jīng)營商戶號，需要先開通場景經(jīng)營商戶號才可以調(diào)用。
2.6.2.3 Q：調(diào)用自定義交易組件創(chuàng)建售后接口ecaftersale/add時報錯2747002，參數(shù)錯誤{“errcode”:2747002,“errmsg”:"參數(shù)錯誤 "}
A9：1.請檢查“orderamt”參數(shù)，傳參金額應(yīng)不含郵費。
2.新舊接口不可混合調(diào)用，新接口不支持對舊接口生成的訂單創(chuàng)建售后。
2.6.2.4 Q：調(diào)用自定義交易組件創(chuàng)建售后接口ecaftersale/add時報47001錯誤{“errcode”:47001,“errmsg”:"data format error "}
A：請檢查“product_info”字段，注意對應(yīng)類型為“object”。
2.6.2.5 Q：調(diào)用自定義交易組件“同意退款”接口shop/ecaftersale/acceptrefund時報錯“同意退款失敗” {“errcode”:9700209,“errmsg”:"同意退款失敗 退款失敗“}
A：1.該問題是訂單流轉(zhuǎn)狀態(tài)不對導(dǎo)致，請嚴(yán)格按照文檔流程進行操作調(diào)用；
2.新舊接口混合調(diào)用也會報此錯誤
3.“orderamt"傳參為"0”
2.6.2.6 Q：用自定義交易組件創(chuàng)建售后接口ecaftersale/add時是報錯“售后金額不合法，大于最大可退款金額”{“errcode”:2747014,“errmsg”:" 售后金額不合法，大于最大可退款金額"}
A：1.請確認(rèn)請求創(chuàng)建售后時"orderamt"金額是否大于下單時"sku_real_price"金額
2.訂單已進行部分退款
