自定義交易組件

本文主要介紹新版自定義交易組件的業(yè)務(wù)流程及各流程的注意事項(xiàng)，文檔篇幅較長(zhǎng)，如無(wú)需查看完整文檔可以使用瀏覽器自帶頁(yè)面搜索功能進(jìn)行關(guān)鍵字搜索（快捷鍵Ctrl+F ）。
在開(kāi)始開(kāi)發(fā)前應(yīng)確認(rèn)以下必要前置條件是否完成：
1、開(kāi)通場(chǎng)景經(jīng)營(yíng)商戶(hù)號(hào)；
2、部分接口強(qiáng)制校驗(yàn)來(lái)源IP白名單，白名單配置方式：
1）服務(wù)商配置方式"點(diǎn)我查看"
2）普通小程序：登錄小程序管理后臺(tái)->開(kāi)發(fā)管理->開(kāi)發(fā)設(shè)置->“開(kāi)發(fā)者ID”下的“IP白名單”
3、因視頻號(hào)場(chǎng)景受控訂單無(wú)微信支付回調(diào)，支付結(jié)果等事件是通過(guò)小程序消息推送進(jìn)行下發(fā)的，需要登錄小程序管理后臺(tái)后，在「開(kāi)發(fā)」-「開(kāi)發(fā)設(shè)置」-「消息推送」中啟用并設(shè)置消息推送配置，開(kāi)發(fā)者接收到的消息需要解密， 消息加解密說(shuō)明可在開(kāi)發(fā)文檔查詢(xún)。

1、業(yè)務(wù)流程圖

1.1 關(guān)鍵流程邏輯

1.2 售后流程

1.3 主要業(yè)務(wù)變動(dòng)

2、接入流程詳細(xì)說(shuō)明

整體接入流程

注：本文2.1-2.2為前置必做流程，完成后才可以進(jìn)行接口調(diào)試

2.1 開(kāi)通自定義交易組件

2.1.1 公眾平臺(tái)后臺(tái)開(kāi)通

登錄公眾平臺(tái),點(diǎn)擊功能下方的“交易組件”，點(diǎn)擊“開(kāi)通”閱讀并同意開(kāi)通協(xié)議后即可進(jìn)行下一步操作。

開(kāi)通后頁(yè)面如圖所示

2.1.2 接口申請(qǐng)開(kāi)通

調(diào)用接口 “shop/register/apply” 申請(qǐng)開(kāi)通自定義版交易組件，請(qǐng)求成功后將發(fā)送“法務(wù)協(xié)議確認(rèn)”到管理員微信，管理員需要在“24小時(shí)內(nèi)”點(diǎn)擊該模板消息，并確認(rèn)服務(wù)協(xié)議。服務(wù)協(xié)議簽署成功后，開(kāi)發(fā)者可以通過(guò)“獲取接入狀態(tài)接口（可點(diǎn)擊跳轉(zhuǎn)）”或“”事件回調(diào)“進(jìn)行開(kāi)通狀態(tài)判斷，若狀態(tài)為“已開(kāi)通”，開(kāi)發(fā)者才可以繼續(xù)調(diào)用后續(xù)接口進(jìn)行調(diào)試接入。

2.1.3 自定義交易組件“升級(jí)版”跟升級(jí)前的自定義交易組件有什么區(qū)別，哪些接口需要進(jìn)行升級(jí)？

1.新支付接口，必須走新商戶(hù)號(hào)。
2.取消訂單， 小程序(小程序內(nèi)以及發(fā)現(xiàn)-小程序我的訂單)和視頻號(hào)雙向可取消，之前只可以在小程序上取消，然后同步給視頻號(hào)狀態(tài)。
3.申請(qǐng)退款，小程序和視頻號(hào)雙向可申請(qǐng)退款。
4.申請(qǐng)退貨退款,小程序和視頻號(hào)雙向可申請(qǐng)退貨退款，之前只有小程序上操作。
5.未付款訂單，小程序和視頻號(hào) 可在各自訂單中心重新支付，同步狀態(tài)。
6.確認(rèn)收貨，小程序和視頻號(hào)雙向可確認(rèn)收貨。
7.同步發(fā)貨狀態(tài)接口更新。

2.2 開(kāi)通場(chǎng)景經(jīng)營(yíng)所需商戶(hù)號(hào)

視頻號(hào)場(chǎng)景下，會(huì)通過(guò)開(kāi)通商戶(hù)號(hào)、補(bǔ)齊資料，獲得一個(gè)新的電商收付通的商戶(hù)號(hào)。商家在視頻號(hào)內(nèi)的交易資金流，需要使用這個(gè)新商戶(hù)號(hào)。

• 準(zhǔn)備事項(xiàng)：需準(zhǔn)備營(yíng)業(yè)執(zhí)照、法人身份證、商戶(hù)號(hào)超級(jí)管理員手機(jī)號(hào)、郵箱信息
• 注意事項(xiàng)：小程序超管將作為微信支付商戶(hù)號(hào)的超級(jí)管理員，如管理員已離職、管理員曾變更過(guò)姓名未在小程序后臺(tái)更新等情況，將影響商戶(hù)號(hào)的簽約，請(qǐng)確認(rèn)無(wú)誤后再進(jìn)行商戶(hù)號(hào)申請(qǐng)。

2.2.1 通過(guò)公眾平臺(tái)后臺(tái)申請(qǐng)

在小程序官方后臺(tái)自定義交易組件頁(yè)面，點(diǎn)擊商戶(hù)號(hào)申請(qǐng)所對(duì)應(yīng)的“去開(kāi)通”按鈕進(jìn)入商戶(hù)號(hào)申請(qǐng)頁(yè)面，共計(jì)三部分（不想開(kāi)商戶(hù)號(hào)了，暫時(shí)不放圖）：

2.2.1.1 填寫(xiě)基礎(chǔ)信息

此部分主要為上傳營(yíng)業(yè)執(zhí)照、法人身份證、填寫(xiě)商戶(hù)號(hào)超管信息

2.2.1.2驗(yàn)證賬戶(hù)小額打款/法人驗(yàn)證

此部分會(huì)有兩種情況，如為“小額打款”驗(yàn)證方式，在頁(yè)面輸入收到的打款金額即可；如為法人驗(yàn)證，需要使用實(shí)名認(rèn)證為法人同名微信掃碼進(jìn)行驗(yàn)證。

2.2.1.3確認(rèn)賬戶(hù)真實(shí)性。

點(diǎn)擊“去簽署”按鈕會(huì)展示簽約二維碼，使用超管微信進(jìn)行掃碼，用于確認(rèn)經(jīng)營(yíng)意愿并簽署協(xié)議，完成商戶(hù)號(hào)注冊(cè)。

2.2.2 通過(guò)API接口申請(qǐng)

調(diào)用“提交支付資質(zhì)”接口，提交場(chǎng)景經(jīng)營(yíng)所需商戶(hù)號(hào)申請(qǐng)，提交成功后，商戶(hù)申請(qǐng)是沒(méi)有事件回調(diào)的，需要服務(wù)商主動(dòng)調(diào)用“狀態(tài)查詢(xún)接口”查詢(xún)申請(qǐng)單進(jìn)度，申請(qǐng)單狀態(tài)同“電商收付通二級(jí)商戶(hù)進(jìn)件申請(qǐng)單狀態(tài)查詢(xún)”。此處不做過(guò)多描述，有問(wèn)題可以留言，后續(xù)視情況補(bǔ)充更新。

2.2.3 開(kāi)通場(chǎng)景經(jīng)營(yíng)商戶(hù)常見(jiàn)問(wèn)題

2.2.3.1 Q：新版交易組件需要重新申請(qǐng)商戶(hù)號(hào)嗎？是否可以使用原有商戶(hù)號(hào)？

A：不可以，新版交易組件必須要申請(qǐng)開(kāi)通場(chǎng)景專(zhuān)用商戶(hù)號(hào)

2.2.3.2 Q:新版場(chǎng)景專(zhuān)用商戶(hù)號(hào)費(fèi)率是多少，是否有優(yōu)惠，結(jié)算周期是多久？

A：商戶(hù)號(hào)費(fèi)率為0.6%，無(wú)費(fèi)率優(yōu)惠，結(jié)算周期為7+7日，即用戶(hù)收貨后7天后結(jié)算。

2.2.3.3 Q：申請(qǐng)新商戶(hù)號(hào)時(shí)，最后一步簽約遇到“微信實(shí)名信息與管理員信息不一致”是什么原因？

A：申請(qǐng)新的場(chǎng)景專(zhuān)用商戶(hù)號(hào)時(shí)，“超級(jí)管理員”這一項(xiàng)不支持修改，默認(rèn)為小程序“超級(jí)管理員”實(shí)名信息，如需修改，需要為該用戶(hù)前往成員管理為小程序綁定超級(jí)管理員。

2.2.3.4 Q：申請(qǐng)新的商戶(hù)號(hào)時(shí)，為什么不能修改主體信息?

A：“當(dāng)前主體”這一項(xiàng)不支持修改，因?yàn)樯虘?hù)號(hào)主體必須和該小程序注冊(cè)主體保持一致。

2.2.3.5 Q：通過(guò)新版自定義交易組件申請(qǐng)的場(chǎng)景專(zhuān)用商戶(hù)號(hào)是否對(duì)跨境類(lèi)小程序（自助報(bào)關(guān)）有影響？

A：會(huì)，二級(jí)商戶(hù)當(dāng)前暫不支持自助清關(guān)接口調(diào)用，留意后續(xù)更新通知

2.2.3.6 Q：新商戶(hù)號(hào)是否支持分賬功能？

A：即將支持，敬請(qǐng)期待。

2.3 上傳商品并通過(guò)審核，完成商品接口調(diào)用（僅有API接入方式）

基礎(chǔ)流程，不做過(guò)多說(shuō)明，只寫(xiě)流程、常見(jiàn)錯(cuò)誤和注意事項(xiàng)

2.3.1 添加商品流程：

（1）首先去“獲取類(lèi)目詳情”，與自己的系統(tǒng)商品類(lèi)目相匹配
（2）查看對(duì)應(yīng)類(lèi)目是否需要行業(yè)資質(zhì)，如果需要，請(qǐng)上傳相關(guān)資質(zhì)
（3）“上傳相關(guān)類(lèi)目資質(zhì)”獲得對(duì)應(yīng)類(lèi)目的使用權(quán)限
（4）如果商品有品牌，“上傳品牌信息”獲得品牌的使用權(quán)限
（5）調(diào)用“添加商品”接口將商品進(jìn)行上傳

2.3.2 SPU接口常見(jiàn)錯(cuò)誤及注意事項(xiàng)

2.3.2.1 Q：自定義交易組件提交上傳類(lèi)目資質(zhì)時(shí)報(bào)錯(cuò){“errcode”: 1000009, “errmsg”: “調(diào)用的類(lèi)目id不存在”}

A: 調(diào)用獲取類(lèi)目詳情，看對(duì)應(yīng)““qualification_type"與"product_qualification_type"參數(shù)是否為"0”，為"0"無(wú)需上傳類(lèi)目資質(zhì)

2.3.2.2 Q：調(diào)用自定義交易組件“添加商品”接口shop/spu/add時(shí)報(bào)錯(cuò)“該賬號(hào)客服方式必須包含微信客服/小程序客服” {“errcode”:1040042,“errmsg”:"該賬號(hào)客服方式必須包含微信客服/小程序客服”}

A11:需要在MP后臺(tái)配置微信客服/小程序客服后，然后通過(guò)“更新商家信息”接口更新商家信息

調(diào)用“獲取商家信息”接口應(yīng)返回一下內(nèi)容才為成功，“service_agent_type”字段需要同時(shí)包含0，1，2三個(gè)值

2.3.2.3 Q：類(lèi)目審核成功，但是添加商品報(bào)錯(cuò)，{“errcode”:1000005,“errmsg”:"該商品使用了未申請(qǐng)通過(guò)的類(lèi)目，請(qǐng)先申請(qǐng)類(lèi)目且通過(guò)后再提審商品 "}

A: 檢查是否取消開(kāi)通過(guò)，取消開(kāi)通會(huì)清空品牌類(lèi)目。對(duì)于服務(wù)商，可以監(jiān)聽(tīng)賬戶(hù)接入回調(diào)事件，目前只有取消開(kāi)通回調(diào)。

2.3.2.4 Q：調(diào)用自定義組件上傳圖片接口報(bào)錯(cuò){“errcode”:1070001,“errmsg”:"文件/圖片為空 "}

A25:檢查請(qǐng)求報(bào)文協(xié)議，需Content-Type: multipart/form-data

2.4 調(diào)試支付校驗(yàn)，完成訂單接口調(diào)用

2.4.1 支付流程：

（1）按照"開(kāi)發(fā)指引"修改基礎(chǔ)庫(kù)配置
（2）在小程序中調(diào)用"生成訂單"接口生成一筆訂單
（3）完成訂單的支付（視頻號(hào)場(chǎng)景需要調(diào)用生成支付參數(shù)后完成收銀臺(tái)的拉起，其他場(chǎng)景按照已有業(yè)務(wù)邏輯進(jìn)行支付）
（4）調(diào)用"同步訂單支付結(jié)果"接口同步訂單的支付結(jié)果（二級(jí)商戶(hù)單無(wú)需同步支付結(jié)果，系統(tǒng)自動(dòng)流轉(zhuǎn)訂單狀態(tài)）

注意：

• 這里兩個(gè)接口都需要調(diào)用，以同步訂單結(jié)果為最后確認(rèn)步驟，視頻號(hào)場(chǎng)景則以支付成功作為最終確認(rèn)步驟。
• 基礎(chǔ)庫(kù)拉起收銀臺(tái)接口改造后需要發(fā)版才可以生效。
• 完成接口調(diào)用后，點(diǎn)擊完成，切換狀態(tài)。

2.4.2 訂單接口接口常見(jiàn)錯(cuò)誤及注意事項(xiàng)

2.4.2.1 Q：二級(jí)商戶(hù)號(hào)訂單支付流程與原有訂單支付流程有什么區(qū)別？

A17:主要區(qū)別是：二級(jí)商戶(hù)號(hào)訂單調(diào)起支付所需參數(shù)是通過(guò)“生成支付參數(shù)”獲取，無(wú)需同步支付結(jié)果；原流程調(diào)起支付是需要通過(guò)微信支付統(tǒng)一下單獲取，需要同步支付結(jié)果。

2.4.2.2 Q：調(diào)用自定義交易組件“創(chuàng)建訂單”接口shop/order/add時(shí)報(bào)錯(cuò)“不支持的發(fā)貨方式” {“errcode”:1010036,“errmsg”:"不支持的發(fā)貨方式“}

A：視頻號(hào)場(chǎng)景當(dāng)前只支持“正?？爝f”方式，其他請(qǐng)留意后續(xù)更新。

2.4.2.3 Q：自定義交易組件申請(qǐng)視頻號(hào)專(zhuān)用商戶(hù)號(hào)后，喚起支付報(bào)錯(cuò): “商戶(hù)號(hào)該產(chǎn)品權(quán)限未開(kāi)通”

A:需要先調(diào)用“生成訂單”接口，生成訂單時(shí)將fund_type設(shè)為1，然后調(diào)用“生成支付參數(shù)”接口獲取調(diào)取支付所需參數(shù)，不要調(diào)用微信支付統(tǒng)一下單接口獲取調(diào)用支付參數(shù)

2.4.2.4 Q：自定義交易組件二級(jí)商戶(hù)單調(diào)起支付時(shí)報(bào)錯(cuò)“JSAPI缺少參數(shù)total_fee”

A:生成支付參數(shù)失敗，沒(méi)返回正確的預(yù)支付 ID，重新調(diào)用生成支付參數(shù)接口獲取新的支付參數(shù)即可

2.4.2.5 Q：自定義交易組件調(diào)用同步訂單支付結(jié)果時(shí)報(bào)錯(cuò) {“errcode”:990022,“errmsg”:"暫不支持操作“}

A：二級(jí)商戶(hù)單無(wú)需同步支付結(jié)果，付款成功后系統(tǒng)自動(dò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ā)貨接口常見(jiàn)錯(cuò)誤及注意事項(xiàng)

注意事項(xiàng)：

• 視頻號(hào)訂單狀態(tài)流轉(zhuǎn)不可逆的，當(dāng)finish_all_delivery=0時(shí)，訂單狀態(tài)流轉(zhuǎn)到21（部分發(fā)貨）， 當(dāng)finish_all_delivery=1時(shí)，訂單狀態(tài)從20（待發(fā)貨）/ 21(部分發(fā)貨）流轉(zhuǎn)到30（待收貨），部分發(fā)貨時(shí)finish_all_delivery一定要傳0，最后一次發(fā)貨才可以傳1，切記！切記！切記！?。?/li>

2.5.2.1 Q：調(diào)用自定義交易組件“創(chuàng)建訂單”接口shop/order/add時(shí)報(bào)錯(cuò)“不支持的發(fā)貨方式” {“errcode”:1010036,“errmsg”:"不支持的發(fā)貨方式“}

A：視頻號(hào)場(chǎng)景當(dāng)前只支持“正?？爝f”方式，其他請(qǐng)留意后續(xù)更新。

2.5.2.2 Q：當(dāng)自定義交易組件訂單只存在一個(gè)SKU，發(fā)貨時(shí)誤操作為部分發(fā)貨，訂單狀態(tài)碼流轉(zhuǎn)為21時(shí)，在既不能確認(rèn)收貨、也不能退款的情況下應(yīng)該如何處理？

A：按照截圖示例傳參，即可完成發(fā)貨，訂單狀態(tài)由21轉(zhuǎn)為30，訂單狀態(tài)變更后就可以正常流轉(zhuǎn)
注：傳參時(shí)order_id與out_order_id二選一傳參

2.6 調(diào)試售后接口，完成售后接口調(diào)用

2.6.1 售后流程、超時(shí)時(shí)間及售后事件和API、回調(diào)的對(duì)應(yīng)關(guān)系

看本文1.2 售后流程圖
用戶(hù)及商戶(hù)處理售后超時(shí)時(shí)間

售后事件和API、回調(diào)的對(duì)應(yīng)關(guān)系

2.6.2 售后接口常見(jiàn)錯(cuò)誤及注意事項(xiàng)

注意事項(xiàng)

• 新舊接口不可混用，新售后接口無(wú)法處理舊接口訂單，否則會(huì)出現(xiàn)很多意想不到的錯(cuò)誤

2.6.2.1 枚舉值定義

（1）AfterSalesReason

（2）AfterSalesState

2.6.2.2 Q：調(diào)用自定義交易組件售后相關(guān)接口：“創(chuàng)建售后單”、“用戶(hù)取消售后單”、“用戶(hù)上傳物流信息”、“獲取售后單列表”、“獲取售后單詳情”、“同意退款“、”同意退貨“、“拒絕售后”、“上傳退款憑證”、“更新售后單”等接口時(shí)報(bào)錯(cuò){“errcode”: 48001,“errmsg”: “api unauthorized”}

A18:未開(kāi)通視頻號(hào)場(chǎng)景經(jīng)營(yíng)商戶(hù)號(hào)，需要先開(kāi)通場(chǎng)景經(jīng)營(yíng)商戶(hù)號(hào)才可以調(diào)用。

2.6.2.3 Q：調(diào)用自定義交易組件創(chuàng)建售后接口ecaftersale/add時(shí)報(bào)錯(cuò)2747002，參數(shù)錯(cuò)誤{“errcode”:2747002,“errmsg”:"參數(shù)錯(cuò)誤 "}

A9：1.請(qǐng)檢查“orderamt”參數(shù)，傳參金額應(yīng)不含郵費(fèi)。
2.新舊接口不可混合調(diào)用，新接口不支持對(duì)舊接口生成的訂單創(chuàng)建售后。

2.6.2.4 Q：調(diào)用自定義交易組件創(chuàng)建售后接口ecaftersale/add時(shí)報(bào)47001錯(cuò)誤{“errcode”:47001,“errmsg”:"data format error "}

A：請(qǐng)檢查“product_info”字段，注意對(duì)應(yīng)類(lèi)型為“object”。

2.6.2.5 Q：調(diào)用自定義交易組件“同意退款”接口shop/ecaftersale/acceptrefund時(shí)報(bào)錯(cuò)“同意退款失敗” {“errcode”:9700209,“errmsg”:"同意退款失敗 退款失敗“}

A：1.該問(wèn)題是訂單流轉(zhuǎn)狀態(tài)不對(duì)導(dǎo)致，請(qǐng)嚴(yán)格按照文檔流程進(jìn)行操作調(diào)用；
2.新舊接口混合調(diào)用也會(huì)報(bào)此錯(cuò)誤
3.“orderamt"傳參為"0”

2.6.2.6 Q：用自定義交易組件創(chuàng)建售后接口ecaftersale/add時(shí)是報(bào)錯(cuò)“售后金額不合法，大于最大可退款金額”{“errcode”:2747014,“errmsg”:" 售后金額不合法，大于最大可退款金額"}

A：1.請(qǐng)確認(rèn)請(qǐng)求創(chuàng)建售后時(shí)"orderamt"金額是否大于下單時(shí)"sku_real_price"金額
2.訂單已進(jìn)行部分退款