本地组件 之前曾写过“新版自定义交易组件接入指引”，广受好评，解决了很多开发者接入时遇到的问题，当然，其中也不乏一些喂不饱的白眼狼，得到便利还反咬一口，无耻至极。 本文主要介绍本地组件产品的业务流程及内测期间各流程的注意事项，文档篇幅较长，如无需查看完整文档可以使用浏览器自带页面搜索功能进行关键字搜索（快捷键Ctrl+F ），组件目前还在内测中，如无法获取内测权限请耐心等待正式上线（因未给某人提供申请方式，大佬都被喷退群了，太令人失望啦）。 本文由Memory的小跟班编写，内容如有错误请指正，勿喷。 良言一句三冬暖，恶语伤人六月寒。 1、产品介绍 本地生活服务行业的商家，可通过"本地组件" （无需新申请专用商户号）将小程序中的商品（兑换券）上架到视频号橱窗，用户在视频号购买兑换券后可在线上/线下二次核销，实现到店核销（自提）/到家配送（同城）的业务场景。 业务流程图 [图片] 用户交互示意 [图片] 2、开通方式 2.1 权限开通 商家符合接入要求或收到内测邀请后需要准备好以下资料：商家名称、视频号名称、小程序名称、小程序APPID等填写报名申请表，此处不作报名表单提供，请自行通过自有资源获取，提交表单后，正常审核时效为1个工作日。 2.2 资质要求 内测期间，商家需要发邮件提交准入资质材料用于资质审核；组件正式上线后可通过MP后台「交易组件」入口开通的「本地组件」提交对应资质审核 2.2.1 商超购百行业（如：万达、天虹） 本规则适用于入驻视频号橱窗的所有需要使用本地组件的商超购百商家 商家类型 资质类型 资质要求 商超购百 营业执照 营业执照 商超购百 商标 1.资质主体与入驻主体（小程序）一致 <br> 2.需提供35类服务商标 <br> 3.若为关联公司或代运营公司入驻，需提供上述商标权利人的委托函或授权书 商超购百 门店数量要求 1.线下业务：以服务类商标命名的实体门店>1家 <br> 2.线上业务：以服务类商标命名的官方网站、独立app或其他平台 商超购百 门店品牌授权要求 提供不少于3个，在经营销售的合作或授权经销协议（协议方需为京东/天猫官方旗舰店或旗舰店品牌） 商超购百 承诺函 承诺在视频号橱窗中所售商品均为正规渠道授权经销商品，保证商品质量，遇到售后和纠纷问题协助视频号团队友好协商处理。 2.2.2 酒旅景区行业（如：万豪、维也纳、迪士尼、长隆） 本规则适用于入驻视频号橱窗的所有需要使用本地组件的酒店/景区商家，暂不支持旅行社 商家类型 资质类型 资质要求 酒旅商家 营业执照 营业执照 酒旅商家 商标 1.资质主体与入驻主体（小程序）一致 <br> 2.品牌商标 <br> 3.若为关联公司或代运营公司入驻，需提供上述商标权利人的委托函或授权书 酒旅商家 其他资质 「单体酒店」需提供：1. 卫生许可证 <br> 2.特种行业许可证 <br> 3.如涉及自助餐券需提交餐饮服务许可（如已三证合一可提交食品经营许可）<br> 提供四星级/五星级酒店证书 <br> 「酒店/度假村集团」需提供：1. 集团旗下一家酒店的资质（同单体酒店）<br> 2. 集团与该提供资质的酒店之间的管理关系证明并附集团旗下所有酒店名单 <br> 「全国/全球连锁主题乐园」主体需提供：1. 娱乐经营许可证 <br>「景区」需提供（任选其一）：1.全国旅游景区质量等级评定委员会出具的《旅游景区质量等级证书》 <br> 2. 旅游局景区等级评定委员会红头文件 <br> 3.提供4A以上景区证书 酒旅商家 承诺函 承诺在视频号橱窗中开展相关业务，保证为视频号用户提供商品购买后的线下履约能力，遇到售后和纠纷问题协助视频号团队友好协商处理。 2.2.3 餐饮行业（如：麦当劳、肯德基、喜茶、瑞幸） 本规则适用于入驻视频号橱窗的所有需要使用本地组件的餐饮商家 商家类型 资质类型 资质要求 餐饮商家 营业执照 营业执照 餐饮商家 商标 1.资质主体与入驻主体（小程序）一致 <br> 2.品牌商标 <br> 3.若为关联公司或代运营公司入驻，需提供上述商标权利人的委托函或授权书 餐饮商家 门店数量要求 以上述商标命名的实体门店，全国实体店数量≥100家（美团/点评门店信息截图或百度/高德POI信息截图） 餐饮商家 其他资质 1.餐饮店主体： 需提供申请主体的「食品经营许可证（经营范围需包含餐饮制作相关项目）扫描件」 <br> 2. 非餐饮主体需提供：a) 《餐饮平台与门店的管理关系声明》 b) 《餐饮门店运营资质和责任承诺函》（含旗下所有门店名单） c）卡券使用门店的「食品经营许可证（经营范围需包含餐饮制作相关项目）扫描件」 餐饮商家 承诺函 承诺在视频号橱窗中开展相关业务，保证为视频号用户提供商品购买后的线下履约能力，遇到售后和纠纷问题协助视频号团队友好协商处理。 2.2.4 其他行业（如：电影、演出、健身、体检、买菜等） 本规则适用于提供本地生活服务的商家，如电影、演出、健身、体检、买菜、按摩、KTV等线下服务商家。 商家类型 资质类型 资质要求 到店综合 营业执照 营业执照 到店综合 商标 1.资质主体与入驻主体（小程序）一致 <br> 2.品牌商标 <br> 3.若为关联公司或代运营公司入驻，需提供上述商标权利人的委托函或授权书 到店综合 门店数量要求 1.线上平台经营型商家（美团、携程、猫眼电影等）需提供官网，需要有开设以35类服务类型品牌商标命名的官方网站、独立APP或在其他平台上经营卖场型店铺。 <br> 2.线下经营商家（如爱康国宾体检）以上述品牌商标命名的实体门店，全国实体店数量≥100家（美团/点评门店信息截图或百度/高德POI信息截图） 到店综合 其他资质 1.餐饮店主体： 需提供申请主体的「食品经营许可证（经营范围需包含餐饮制作相关项目）扫描件」 <br> 2. 非餐饮主体需提供：a) 《餐饮平台与门店的管理关系声明》 b) 《餐饮门店运营资质和责任承诺函》（含旗下所有门店名单） c）卡券使用门店的「食品经营许可证（经营范围需包含餐饮制作相关项目）扫描件」 到店综合 承诺函 承诺在视频号橱窗中开展相关业务，保证为视频号用户提供商品购买后的线下履约能力，遇到售后和纠纷问题协助视频号团队友好协商处理。 3、协议相关 本地组件正式上线后，商家在开通本地组件时，会查看和签订本地组件协议，协议将定义本地组件业务模式、技术服务费比例、对账周期、打款周期、打款账号等内容． 本地组件正式上线后，预计会按「月」为周期结算，收取商家在视频号场景下支付GMV*1%的技术服务费。 4、文档接口 暂不在本文提供，后续更新接入时的一些问题 5、带货测试 上架商品，商品审核，保证金提交，直播卖货，支付，订单发货，退货等环节测试。 6、对账打款测试 双方进行账单对账，技术服务费对账，商家请求打款，技术服务费打款测试。 内测期问，预计月初通过邮件将账单发给商家对接人进行对账，商家完成小额打款测试， 正式上线后，平台预计在每个月1号出对账单，商家在5个工作日确认对账单无误后，在20个工作日内完成打款。 [图片] 7、异常情况测试 保证金延迟提交会限制带货能力，佣金延迟打款限制带货能力等一场逻辑测试。 8、 FAQ 8.1 视频号小店、自定义交易组件、新版自定义交易组件、视频号交易组件与本地组件的区别 能力 商户号 业务类型 发货类型 技术服务费 本地组件 原小程序商户号 团购兑换券 本地配送/到店自提 支付口径/统一比例 自定义交易组件 原小程序商户号 商品/兑换券 快递/同城/到店 无 新版自定义交易组件 新申请二级商户号 商品/兑换券 快递/同城/到店 结算口径/分类目 视频号交易组件 新申请二级商户号 商品 快递/免物流 结算口径/分类目 视频号小店 新申请二级商户号 商品 快递/免物流 结算口径/分类目 自定义交易组件将会在4月底下限，届时通过自定义交易组件上架的商品将会失效，若商家在视频号继续经营卖货，需要接入「本地组件」或者「视频号交易组件/视频号小店」 8.2 本地组件的商家，如何售卖电商物流发货商品？ 目前一个视频号只能关联一个视频号小店 或一个组件，内测期间，用新的视频号开通视频号小店，上架标准电商发货商品，上传至“优选联盟”。商家视频号通过优选联盟分销电商商品，区别本地生活售卖券，（也可以通过带货团长来实现）未来会支持视频号可同时关联本地组件和视频号小店。 8.3 本地组件的商家，如何缴纳保证金，缴纳多少？ 本地组件商家保证金沿用已发布的橱窗保证金规则，自营账户交3万元保证金，其他推广员交100元保证金。具体规则可参考「视频号橱窗保证金条款 」 未完待续······

本文不在更新，请看新版自定义交易组件接入指引 看帖不点赞，bug千千万 需要先申请开通“交易组件场景专用商户号”才可以完成新版交易组件场景接入（申请场景经营商户号这是必要条件），进行接入时一定要按照文档流程顺序进行接入，不要新旧接口混合调用，否则无法正常跑通完整流程，切记！切记！切记！ 先配个图证明新版接入已完成 [图片] 有新问题可以留言，有准确答案（方案）后补充更新 一、升级版自定义交易组件接入说明 1、组件介绍 若商家此前已经完成视频号接入小程序，在小程序中调用升级版自定义交易组件组件后，可在保留原有的界面、功能及交易链路的情况下接入微信视频号场景。通过调用商品上传、订单生成、状态同步等接口，实现在视频号场景中交易资金流、售后、交易纠纷、客服等能力的标准化。 2、功能特点 可在视频号场景实现商品展示和带货等功能 未来可支持更多直播营销玩法(券、 秒杀、预售等) 支持小程序客服组件，商家能更方便收到用户的客服咨询 订单中心显示更完善的订单信息，用户可自行查看订单状态 支持用户在视频号订单中心继续付款、发起售后 3、上线案例 升级版自定义交易组件为商户提供保障用户体验的直播电商全链路能力: 可以使用微信支付商户号，资金结算更规范。 小程序和视频号的订单进行了双向打通，用户可以任选在小程序或视频号订单中心处理订单，例如重新发起支付、确认收货等，大大提升用户体验。 通过打通小程序客服组件，增强了商家处理商品咨询的能力。 [图片][图片][图片] 4、接入流程及官方文档 注意:整个接入流程需要15-30个工作日不等，建议提前准备商品的品牌、资质、类目信息，与开发调试并行，避免延误直播带货计划。 详情见：接入视频号指引 5、关键流程逻辑 注意“橙色”为新加入部分: [图片] [图片] 二、接入过程中常见问题 有新问题可以留言，有准确答案（方案）后补充更新 Q1:新版交易组件需要重新申请商户号吗？是否可以使用原有商户号？ A1：不可以，新版交易组件必须要申请开通场景专用商户号 Q2:新版场景专用商户号费率是多少，是否有优惠，结算周期是多久？ A2：商户号费率为0.6%，无费率优惠，结算周期为7+7日，即用户收货后7天后结算。 Q3:申请新商户号时，最后一步签约遇到“微信实名信息与管理员信息不一致”是什么原因？ A3：申请新的场景专用商户号时，“超级管理员”这一项不支持修改，默认为小程序“超级管理员”实名信息，如需修改，需要为该用户前往成员管理为小程序绑定超级管理员。 Q4:申请新的商户号时，为什么不能修改主体信息? A4：“当前主体”这一项不支持修改，因为商户号主体必须和该小程序注册主体保持一致。 Q5:通过新版自定义交易组件申请的场景专用商户号是否对跨境类小程序（自助报关）有影响？ A5：会，二级商户当前暂不支持自助清关接口调用，留意后续更新通知 Q6:自定义交易组件“升级版”跟升级前的自定义交易组件有什么区别，哪些接口需要升级? A6: 新支付接口，必须走新商户号。 取消订单， 小程序(小程序内以及发现-小程序我的订单)和视频号双向可取消，之前只可以在小程序上取消，然后同步给视频号状态。 申请退款，小程序和视频号双向可申请退款。 申请退货退款,小程序和视频号双向可申请退货退款，之前只有小程序上操作。 未付款订单，小程序和视频号 可在各自订单中心重新支付，同步状态。 确认收货，小程序和视频号双向可确认收货。 同步发货状态接口更新。 Q7：自定义交易组件验收流程走完后, 在MP后台点击完成依旧提示"检测到你未完成此项步骤, 请确认后重试"是什么原因？ A7：需要通过调用新接口进行验收才可以通过。 Q8：调用自定义交易组件创建售后接口ecaftersale/add时报47001错误{“errcode”:47001,“errmsg”:"data format error "} A8：请检查“product_info”字段，注意对应类型为“object”。 Q9：调用自定义交易组件创建售后接口ecaftersale/add时报错2747002，参数错误{“errcode”:2747002,“errmsg”:"参数错误 "} A9：1.请检查“orderamt”参数，传参金额应不含邮费。 2.新旧接口不可混合调用，新接口不支持对旧接口生成的订单创建售后。 3.一个商品仅可以有一笔在流程的售后单，已创建或售后完结也会报次错误。 Q10：调用自定义交易组件“同意退货”接口ecaftersale/acceptreturn时报错“同意退货失败没有默认退货地址，需要在接口中传入” {“errcode”:9700210,“errmsg”:“errmsg” =>”同意退货失败没有默认退货地址，需要在接口中传入"} A10：需要调用“更新商家信息”接口，补充默认退货地址 Q11：调用自定义交易组件“添加商品”接口shop/spu/add时报错“该账号客服方式必须包含微信客服/小程序客服” {“errcode”:1040042,“errmsg”:"该账号客服方式必须包含微信客服/小程序客服”} A11:需要在MP后台配置微信客服/小程序客服后，然后通过“更新商家信息”接口更新商家信息[图片] 调用“获取商家信息”接口应返回一下内容才为成功，“service_agent_type”字段需要同时包含0，1，2三个值 [图片] Q12：调用自定义交易组件“创建订单”接口shop/order/add时报错“不支持的发货方式” {“errcode”:1010036,“errmsg”:"不支持的发货方式“} A12：视频号场景当前只支持“正常快递”方式，其他请留意后续更新。 Q13：自定义交易组件“创建售后单”接口中“refund_reason_type”字段 定义见枚举值定义 “emAfterSalesReason ”，“emAfterSalesReason”对应枚举值是什么？ A13:INCORRECT_SELECTION = 1; // 拍错/多拍 NO_LONGER_WANT = 2; // 不想要了 NO_EXPRESS_INFO = 3; // 无快递信息 EMPTY_PACKAGE = 4; // 包裹为空 REJECT_RECEIVE_PACKAGE = 5; // 已拒签包裹 NOT_DELIVERED_TOO_LONG = 6; // 快递长时间未送达 NOT_MATCH_PRODUCT_DESC = 7; // 与商品描述不符 QUALITY_ISSUE = 8; // 质量问题 SEND_WRONG_GOODS = 9; // 卖家发错货 THREE_NO_PRODUCT = 10; // 三无产品 FAKE_PRODUCT = 11; // 假冒产品 OTHERS = 12; // 其它 Q14:自定义交易组件“获取售后单详情”接口中“status”字段 定义见枚举值定义 “AfterSalesState ”，“AfterSalesState”对应枚举值是什么？ A14:AFTERSALESTATUS_INVALID = 0; USER_CANCELD = 1; // 用户取消申请 MERCHANT_PROCESSING = 2; // 商家受理中 MERCHANT_REJECT_REFUND = 4; // 商家拒绝退款 MERCHANT_REJECT_RETURN = 5; // 商家拒绝退货退款 USER_WAIT_RETURN = 6; // 待买家退货 RETURN_CLOSED = 7; // 退货退款关闭 MERCHANT_WAIT_RECEIPT = 8; // 待商家收货 MERCHANT_OVERDUE_REFUND = 12; // 商家逾期未退款 MERCHANT_REFUND_SUCCESS = 13; // 退款完成 MERCHANT_RETURN_SUCCESS = 14; // 退货退款完成 PLATFORM_REFUNDING = 15; // 平台退款中 PLATFORM_REFUND_FAIL = 16; // 平台退款失败 USER_WAIT_CONFIRM = 17; // 待用户确认 MERCHANT_REFUND_RETRY_FAIL = 18; // 商家打款失败，客服关闭售后 MERCHANT_FAIL = 19; // 售后关闭 Q15：自定义交易组件申请视频号专用商户号后，唤起支付报错: “商户号该产品权限未开通” A15:需要先调用“生成订单”接口，然后调用“生成支付参数”接口获取调取支付所需参数，不要调用微信支付统一下单接口获取调用支付参数 Q16：调用自定义交易组件“同意退款”接口shop/ecaftersale/acceptrefund时报错“同意退款失败” {“errcode”:9700209,“errmsg”:"同意退款失败 退款失败“} A：该问题是订单流转状态不对导致，请严格按照文档流程进行操作调用；新旧接口混合调用也会报此错误。 Q17：二级商户号订单支付流程与原有订单支付流程有什么区别？ A17:主要区别是：二级商户号订单调起支付所需参数是通过“生成支付参数”获取，无需同步支付结果；原流程调起支付是需要通过微信支付统一下单获取，需要同步支付结果。 Q18：调用自定义交易组件售后相关接口：“创建售后单”、“用户取消售后单”、“用户上传物流信息”、“获取售后单列表”、“获取售后单详情”、“同意退款“、”同意退货“、“拒绝售后”、“上传退款凭证”、“更新售后单”等接口时报错{“errcode”: 48001,“errmsg”: “api unauthorized”} A18:未开通视频号场景经营商户号，需要先开通场景经营商户号才可以调用。 Q19:自定义交易组件二级商户单调起支付时报错“JSAPI缺少参数total_fee” A19:生成支付参数失败，没返回正确的预支付 ID，重新调用生成支付参数接口获取新的支付参数即可 Q20：调用自定义交易组件接口报错{“errcode”:61007,“errmsg”:“api is unauthorized to component”} A20:没有完成服务商授权。 Q21：已经开通了自定义交易组件，调用接口还是报错48001 A21:接口鉴权有本地缓存，一般最多10分钟，请稍后再试。 Q22:调用自定义组件接口报错“json异常” A22:结构体比较复杂，请检查字段层级。划重点： json不支持注释！！！json不支持注释！！！json不支持注释！！！ Q23:调用自定义组件接口报错{“errcode”:1000000,“errmsg”:“订单状态流转异常”} A23: 订单严格按照：创建、支付、发货、收货的事件流转，如果已经取消，则不能继续流转。 Q24:调用自定义组件上传图片接口报错{“errcode”:1070008,“errmsg”:"获取图片失败，请使用流式上传 "} A24:一般是图片url在微信侧获取不刀，可能为图片cdn设置了白名单或者cdn服务商把微信出口ip 给“ban”了 Q25:调用自定义组件上传图片接口报错{“errcode”:1070001,“errmsg”:"文件/图片为空 "} A25:检查请求报文协议，需[代码]Content-Type: multipart/form-data[代码] Q26:调用自定义组件上传图片接口报错{“errcode”:1000035,“errmsg”:"无效链接 "} A26:请检查图片链接是否为有效链接 Q27:自定义交易组件接入后没有收到事件回调消息 A27:使用公众平台调试工具确保回调链路正常。事件消息如下 [图片] Q28:视频号橱窗管理获取不到对应小程序 A28:1、检查是否开通视频号场景；2、检查是否绑定了推广员（非小程序超管需要绑定推广员） 持续更新中～～～

自定义交易组件 本文主要介绍新版自定义交易组件的业务流程及各流程的注意事项，文档篇幅较长，如无需查看完整文档可以使用浏览器自带页面搜索功能进行关键字搜索（快捷键Ctrl+F ）。 在开始开发前应确认以下必要前置条件是否完成： 1、开通场景经营商户号； 2、部分接口强制校验来源IP白名单，白名单配置方式： 1）服务商配置方式"点我查看" 2）普通小程序：登录小程序管理后台->开发管理->开发设置->“开发者ID”下的“IP白名单” 3、因视频号场景受控订单无微信支付回调，支付结果等事件是通过小程序消息推送进行下发的，需要登录小程序管理后台后，在「开发」-「开发设置」-「消息推送」中启用并设置消息推送配置，开发者接收到的消息需要解密， 消息加解密说明可在开发文档查询。 1、业务流程图 1.1 关键流程逻辑 [图片] 1.2 售后流程 [图片] 1.3 主要业务变动 [图片] 2、接入流程详细说明 整体接入流程 注：本文2.1-2.2为前置必做流程，完成后才可以进行接口调试 [图片] 2.1 开通自定义交易组件 2.1.1 公众平台后台开通 登录公众平台,点击功能下方的“交易组件”，点击“开通”阅读并同意开通协议后即可进行下一步操作。[图片] 开通后页面如图所示[图片] 2.1.2 接口申请开通 调用接口 “shop/register/apply” 申请开通自定义版交易组件，请求成功后将发送“法务协议确认”到管理员微信，管理员需要在“24小时内”点击该模板消息，并确认服务协议。服务协议签署成功后，开发者可以通过“获取接入状态接口（可点击跳转）”或“”事件回调“进行开通状态判断，若状态为“已开通”，开发者才可以继续调用后续接口进行调试接入。[图片][图片][图片] 2.1.3 自定义交易组件“升级版”跟升级前的自定义交易组件有什么区别，哪些接口需要进行升级？ 1.新支付接口，必须走新商户号。 2.取消订单， 小程序(小程序内以及发现-小程序我的订单)和视频号双向可取消，之前只可以在小程序上取消，然后同步给视频号状态。 3.申请退款，小程序和视频号双向可申请退款。 4.申请退货退款,小程序和视频号双向可申请退货退款，之前只有小程序上操作。 5.未付款订单，小程序和视频号 可在各自订单中心重新支付，同步状态。 6.确认收货，小程序和视频号双向可确认收货。 7.同步发货状态接口更新。 2.2 开通场景经营所需商户号 视频号场景下，会通过开通商户号、补齐资料，获得一个新的电商收付通的商户号。商家在视频号内的交易资金流，需要使用这个新商户号。 准备事项：需准备营业执照、法人身份证、商户号超级管理员手机号、邮箱信息 注意事项：小程序超管将作为微信支付商户号的超级管理员，如管理员已离职、管理员曾变更过姓名未在小程序后台更新等情况，将影响商户号的签约，请确认无误后再进行商户号申请。 2.2.1 通过公众平台后台申请 在小程序官方后台自定义交易组件页面，点击商户号申请所对应的“去开通”按钮进入商户号申请页面，共计三部分（不想开商户号了，暂时不放图）： 2.2.1.1 填写基础信息 此部分主要为上传营业执照、法人身份证、填写商户号超管信息 2.2.1.2验证账户小额打款/法人验证 此部分会有两种情况，如为“小额打款”验证方式，在页面输入收到的打款金额即可；如为法人验证，需要使用实名认证为法人同名微信扫码进行验证。 2.2.1.3确认账户真实性。 点击“去签署”按钮会展示签约二维码，使用超管微信进行扫码，用于确认经营意愿并签署协议，完成商户号注册。 2.2.2 通过API接口申请 调用“提交支付资质”接口，提交场景经营所需商户号申请，提交成功后，商户申请是没有事件回调的，需要服务商主动调用“状态查询接口”查询申请单进度，申请单状态同“电商收付通二级商户进件申请单状态查询”。此处不做过多描述，有问题可以留言，后续视情况补充更新。 2.2.3 开通场景经营商户常见问题 2.2.3.1 Q：新版交易组件需要重新申请商户号吗？是否可以使用原有商户号？ A：不可以，新版交易组件必须要申请开通场景专用商户号 2.2.3.2 Q:新版场景专用商户号费率是多少，是否有优惠，结算周期是多久？ A：商户号费率为0.6%，无费率优惠，结算周期为7+7日，即用户收货后7天后结算。 2.2.3.3 Q：申请新商户号时，最后一步签约遇到“微信实名信息与管理员信息不一致”是什么原因？ A：申请新的场景专用商户号时，“超级管理员”这一项不支持修改，默认为小程序“超级管理员”实名信息，如需修改，需要为该用户前往成员管理为小程序绑定超级管理员。 2.2.3.4 Q：申请新的商户号时，为什么不能修改主体信息? A：“当前主体”这一项不支持修改，因为商户号主体必须和该小程序注册主体保持一致。 2.2.3.5 Q：通过新版自定义交易组件申请的场景专用商户号是否对跨境类小程序（自助报关）有影响？ A：会，二级商户当前暂不支持自助清关接口调用，留意后续更新通知 2.2.3.6 Q：新商户号是否支持分账功能？ A：即将支持，敬请期待。 2.3 上传商品并通过审核，完成商品接口调用（仅有API接入方式） 基础流程，不做过多说明，只写流程、常见错误和注意事项 2.3.1 添加商品流程： （1）首先去“获取类目详情”，与自己的系统商品类目相匹配 （2）查看对应类目是否需要行业资质，如果需要，请上传相关资质 （3）“上传相关类目资质”获得对应类目的使用权限 （4）如果商品有品牌，“上传品牌信息”获得品牌的使用权限 （5）调用“添加商品”接口将商品进行上传 2.3.2 SPU接口常见错误及注意事项 2.3.2.1 Q：自定义交易组件提交上传类目资质时报错{“errcode”: 1000009, “errmsg”: “调用的类目id不存在”} A: 调用获取类目详情，看对应““qualification_type"与"product_qualification_type"参数是否为"0”，为"0"无需上传类目资质 2.3.2.2 Q：调用自定义交易组件“添加商品”接口shop/spu/add时报错“该账号客服方式必须包含微信客服/小程序客服” {“errcode”:1040042,“errmsg”:"该账号客服方式必须包含微信客服/小程序客服”} A11:需要在MP后台配置微信客服/小程序客服后，然后通过“更新商家信息”接口更新商家信息 [图片] 调用“获取商家信息”接口应返回一下内容才为成功，“service_agent_type”字段需要同时包含0，1，2三个值 [图片] 2.3.2.3 Q：类目审核成功，但是添加商品报错，{“errcode”:1000005,“errmsg”:"该商品使用了未申请通过的类目，请先申请类目且通过后再提审商品 "} A: 检查是否取消开通过，取消开通会清空品牌类目。对于服务商，可以监听账户接入回调事件，目前只有取消开通回调。 2.3.2.4 Q：调用自定义组件上传图片接口报错{“errcode”:1070001,“errmsg”:"文件/图片为空 "} A25:检查请求报文协议，需[代码]Content-Type: multipart/form-data[代码] 2.4 调试支付校验，完成订单接口调用 2.4.1 支付流程： （1）按照"开发指引"修改基础库配置 （2）在小程序中调用"生成订单"接口生成一笔订单 （3）完成订单的支付（视频号场景需要调用生成支付参数后完成收银台的拉起，其他场景按照已有业务逻辑进行支付） （4）调用"同步订单支付结果"接口同步订单的支付结果（二级商户单无需同步支付结果，系统自动流转订单状态） 注意： 这里两个接口都需要调用，以同步订单结果为最后确认步骤，视频号场景则以支付成功作为最终确认步骤。 基础库拉起收银台接口改造后需要发版才可以生效。 完成接口调用后，点击完成，切换状态。 2.4.2 订单接口接口常见错误及注意事项 2.4.2.1 Q：二级商户号订单支付流程与原有订单支付流程有什么区别？ A17:主要区别是：二级商户号订单调起支付所需参数是通过“生成支付参数”获取，无需同步支付结果；原流程调起支付是需要通过微信支付统一下单获取，需要同步支付结果。 2.4.2.2 Q：调用自定义交易组件“创建订单”接口shop/order/add时报错“不支持的发货方式” {“errcode”:1010036,“errmsg”:"不支持的发货方式“} A：视频号场景当前只支持“正常快递”方式，其他请留意后续更新。 2.4.2.3 Q：自定义交易组件申请视频号专用商户号后，唤起支付报错: “商户号该产品权限未开通” A:需要先调用“生成订单”接口，生成订单时将fund_type设为1，然后调用“生成支付参数”接口获取调取支付所需参数，不要调用微信支付统一下单接口获取调用支付参数 2.4.2.4 Q：自定义交易组件二级商户单调起支付时报错“JSAPI缺少参数total_fee” A:生成支付参数失败，没返回正确的预支付 ID，重新调用生成支付参数接口获取新的支付参数即可 2.4.2.5 Q：自定义交易组件调用同步订单支付结果时报错 {“errcode”:990022,“errmsg”:"暂不支持操作“} A：二级商户单无需同步支付结果，付款成功后系统自动流转订单状态并下发支付结果回调事件。 2.5 调试发货接口，完成物流相关接口调用 2.5.1 发货流程 （1）先调用获取快递公司列表接口获取快递公司信息 （2）调用"订单发货"接口，完成发货 2.5.2 发货接口常见错误及注意事项 注意事项： 视频号订单状态流转不可逆的，当finish_all_delivery=0时，订单状态流转到21（部分发货）， 当finish_all_delivery=1时，订单状态从20（待发货）/ 21(部分发货）流转到30（待收货），部分发货时finish_all_delivery一定要传0，最后一次发货才可以传1，切记！切记！切记！！！ 2.5.2.1 Q：调用自定义交易组件“创建订单”接口shop/order/add时报错“不支持的发货方式” {“errcode”:1010036,“errmsg”:"不支持的发货方式“} A：视频号场景当前只支持“正常快递”方式，其他请留意后续更新。 2.5.2.2 Q：当自定义交易组件订单只存在一个SKU，发货时误操作为部分发货，订单状态码流转为21时，在既不能确认收货、也不能退款的情况下应该如何处理？ A：按照截图示例传参，即可完成发货，订单状态由21转为30，订单状态变更后就可以正常流转 注：传参时order_id与out_order_id二选一传参 [图片] 2.6 调试售后接口，完成售后接口调用 2.6.1 售后流程、超时时间及售后事件和API、回调的对应关系 看本文1.2 售后流程图 用户及商户处理售后超时时间 类型 超时时间 商家处理退款超时 48小时 商家处理退货超时 48小时 用户超时未申请平台接入 7天 用户上传退货物流超时 7天 商家超时未确认收货 10天 售后事件和API、回调的对应关系 事件 API 触发回调 说明 用户申请退款 用户提交售后申请 用户提交售后申请回调 - 用户申请退货 用户提交售后申请 用户提交售后申请回调 - 用户修改申请 用户更新售后申请 用户更新售后申请回调 - 用户取消申请 用户取消售后申请 用户取消售后申请回调 - 用户申请平台介入 无API，只能由用户在微信侧触发 暂无 - 用户超时未申请平台介入（7天） - 用户申请平台介入超时回调 - 用户上传退货物流 用户上传物流信息 用户上传退货物流回调(待商家确认收货) - 用户超时未上传退货物流（7天） - 用户上传退货物流超时回调 - 用户确认退款凭证 无API，只能由用户在微信侧触发 用户确认退款凭证回调 - 商家同意退款 同意退款 - - 商家处理退款超时（48小时） - 商家处理退款请求超时回调 - 商家同意退货 同意退货 - - 商家处理退货超时（48小时） - 商家处理退货申请超时回调 - 商家拒绝退款 拒绝售后 - - 商家拒绝退货 拒绝售后 - - 商家上传退款凭证 上传退款凭证 - 商家确认收货 同意退款 商家确认收到的货没问题后，调用同意退款API表示确认收货，如果有问题就调用拒绝售后API 商家超时未确认收货（10天） - 商家确认收货超时回调 - 平台退款成功 - 平台退款成功回调 - 平台退款失败 - 平台退款失败回调(待商家线下退款) - 平台判定用户责任 - 纠纷事件更新售后单状态回调 纠纷事件通知请见纠纷回调 平台判定商家退款 - 纠纷事件更新售后单状态回调 纠纷事件通知请见纠纷回调 平台判定商家退货 - 纠纷事件更新售后单状态回调 纠纷事件通知请见纠纷回调 2.6.2 售后接口常见错误及注意事项 注意事项 新旧接口不可混用，新售后接口无法处理旧接口订单，否则会出现很多意想不到的错误 2.6.2.1 枚举值定义 （1）AfterSalesReason 枚举值 描述 1 排错/多拍 2 不想要了 3 无快递信息 4 包裹为空 5 已拒签包裹 6 快递长时间未送达 7 与商品描述不符 8 质量问题 9 卖家发错货 10 三无产品 11 假冒产品 12 其他 （2）AfterSalesState 枚举值 描述 1 用户取消 2 商家受理退款申请中 4 商家拒绝退款 5 商家拒绝退货退款 6 待买家退货 7 售后单关闭 8 待商家收货 11 平台退款中 13 退款成功 21 平台受理退款申请中 22 平台介入处理完成 23 商家受理退货申请中 24 平台受理退货申请中 2.6.2.2 Q：调用自定义交易组件售后相关接口：“创建售后单”、“用户取消售后单”、“用户上传物流信息”、“获取售后单列表”、“获取售后单详情”、“同意退款“、”同意退货“、“拒绝售后”、“上传退款凭证”、“更新售后单”等接口时报错{“errcode”: 48001,“errmsg”: “api unauthorized”} A18:未开通视频号场景经营商户号，需要先开通场景经营商户号才可以调用。 2.6.2.3 Q：调用自定义交易组件创建售后接口ecaftersale/add时报错2747002，参数错误{“errcode”:2747002,“errmsg”:"参数错误 "} A9：1.请检查“orderamt”参数，传参金额应不含邮费。 2.新旧接口不可混合调用，新接口不支持对旧接口生成的订单创建售后。 2.6.2.4 Q：调用自定义交易组件创建售后接口ecaftersale/add时报47001错误{“errcode”:47001,“errmsg”:"data format error "} A：请检查“product_info”字段，注意对应类型为“object”。 2.6.2.5 Q：调用自定义交易组件“同意退款”接口shop/ecaftersale/acceptrefund时报错“同意退款失败” {“errcode”:9700209,“errmsg”:"同意退款失败 退款失败“} A：1.该问题是订单流转状态不对导致，请严格按照文档流程进行操作调用； 2.新旧接口混合调用也会报此错误 3.“orderamt"传参为"0” 2.6.2.6 Q：用自定义交易组件创建售后接口ecaftersale/add时是报错“售后金额不合法，大于最大可退款金额”{“errcode”:2747014,“errmsg”:" 售后金额不合法，大于最大可退款金额"} A：1.请确认请求创建售后时"orderamt"金额是否大于下单时"sku_real_price"金额 2.订单已进行部分退款 码字中 稍后回来

README 基于此Postman-cn脚本完善了自定义交易组件当前已公开接口 好用记得点赞 导入方法 以下操作为MAC OS导入流程 1.打开postman，点击“Import” [图片] 2.点击“upload files” [图片] 3.选择下载好的json 脚本，点击“open” [图片] 4.点击“Import”进行导入 [图片] 配置方法 [图片] 脚本下载地址 下载地址：https://cloud.189.cn/web/share?code=IFVB7rzIBNZn（访问码：2ewk） 如下载地址失效请留言，看到后第一时间更新