注意：自定义交易组件【升级版】，即新接口适配（必须走新商户号）于2022年4月29号下午约15:00发布上线，站点注意更新最新，上传最新小程序代码，完成了小程序代码的发布和上线! 一、功能概述商城接入自定义版交易组件，商家可按流程接入自定义交易组件，实现视频号和微信小程序的打通，助力商家在微信视频号卖货。 二、实现场景实现功能一：用户进入视频号主页时，可直接看到商品橱窗商品，点击商品跳转小程序商城，使用微信支付下单购买，订单同步到微信端。 页面展示： [图片][图片][图片] 实现功能二： 通过微信视频号开启直播，可在商品商城橱窗挑选需要带货商品，用户观看视频号直播，点击商品，跳转小程序商城，用微信支付下单购买，订单同步到微信端。 页面展示： [图片][图片]  三、登录商城后台授权安装启用“自定义交易组件” 安装路径：总后台 -- 安装应用 -- 搜索“自定义交易组件”并安装 启用路径：总后台 -- 系统 -- 插件管理 --启用“自定义交易组件”插件 [图片][图片] 四、小程序官方后台mp.weixin.qq.com配置ip白名单、消息推送、开通自定义交易组件需要注意：1、必须是一个非个人主体的小程序2、小程序类目需要符合下图要求。 [图片] （一）配置ip白名单 因为视频号只能用二级商户订单，必须配置白名单。 路径：开发 -- 开发管理 -- 开发设置 -- 开发者ID -- 添加ip白名单（ip地址为您的服务器ip），需要小程序管理员扫码确认添加。 [图片] 站点没做集群即一台服务器情况下，填写一个服务器ip就行，如下截图 [图片] 站点做集群，填写全部ip，如下截图： [图片] [图片] （二）启用和配置消息推送配置二级订单状态回调，须启用和配置小程序消息推送。 1、路径：开发 -- 开发管理 -- 开发设置  -- 消息推送  [图片] 2、下一步，点击启用（需要小程序管理员扫码确认），填写URL、Token、 EncodingAESKey 消息加密方式：选择“明文” 数据格式：选择“XML” [图片][图片] 3、URL、Token、 EncodingAESKey如何填写？ 进入商城后台 --  应用  -- 公众号  -- 复制服务器地址（URL）、令牌（Token）、消息加密密钥（EncodingAESKey）粘贴到小程序的消息推送处。 [图片] （三）开通自定义交易组件 1、开通路径 路径：小程序后台 -- 功能 -- 交易组件 -- 开通自定义版交易组件。若小程序满足自定义版交易组件的接入要求，在微信公众平台登录小程序，则会看到下图所示界面 [图片] [图片] 微信官方暂时不支持标准交易组件转自定义交易组件，如果之前开错了，只能暂时放弃；也不能主动取消，否则无法再次开通，后续可开通小程序会有站内通知。 [图片] 2、申请开通选择自定义版交易组件，并申请开通功能，进入审核流程。商家也可以通过调用申请接入的接口申请开通功能，申请并审核通过后会看到下面的界面。 注意：这里申请审核时效为1-2个工作日，如果已经接入了回调接口，则会收到申请通过的回调。 [图片] 3、组件接入 （1）商户号申请：场景经营所需商户号的申请，可以查看小程序使用该商户号产生的交易金额、流水，申请、管理及操作。 开通指引如下   ① 点击去开通，申请商户号有三个步骤，先填写“步骤一基础信息”，上传营业执照法人身份证信息。 [图片][图片][图片] [图片] [图片]   ② 补充资料为选填，不用填，直接跳过。 [图片]   ③ 提交后，需要审核，在“基础信息”审核中期间，进行下一步“步骤二验证账户” [图片]   账户验证分两种，选择其中一种方式验证。 验证方式一: 法人验证，在规定时间内使用法人微信号扫一扫进行账户验证。 验证方式二：汇款验证，即公账汇款，在规定时间内使用用户名为“xxxxx公司”的银行账户汇款至指定账户。 [图片]   验证后点击下方的“我知道了”，刷新页面查看最新结果。预计2个工作日内完成审核。 [图片]   ④ 通过后，进行下一步“步骤三 签约开通协议” [图片]   [图片]   小程序管理员或小程序开发者扫码确认签署，手机微信扫码确认流程如下 [图片][图片][图片]   ⑤ 商户号开通后效果如下 [图片] [图片]     （2）商品接口调用：商品添加、商品修改、商品上架、商品下架、商品更新等   ① 路径：在商城后台 -- 自定义交易组件 -- 微信商品列表 -- 新增（上传商品） [图片]   ② 选择商品分类，该分类为微信官方的商品分类，与商城添加的商品分类无关，部分需要审核才能开启的分类会被隐藏，点击更新分类可以从微信官方同步分类数据到本地。（目前只支持选择商城平台自营商品，其他插件商品暂不支持，后续将逐步支持）   [图片]   ③ 选择商品，一次最多选择10个商品，如果该分类需要商品资质证明，在商品列表会出现商品资质按钮（商品资质图片默认取上一次审核时提及的图片），点击后选择图片并上传。 [图片] ④ 点击提交，系统会自动获取商品数据并且提交审核。 ⑤ 提交完毕后会跳转到审核列表。 [图片]       （3）订单接口调用   首先在商城后台自定义交易组件绑定订单调试开通。   类型：普通订单、二级商户订单。（2种类型都要绑定，分开下单绑定对应单号，视频号只能用二级商户订单，绑定没有先后顺序，只要都有绑定订单就行）   接入测试订单流程：先在小程序下单审核商品（仅提交订单不要付款），绑定下单未付款的订单号。   流程说明：该功能仅供接入流程测试使用，一般订单请勿使用 （1）进入小程序商城，选择已通过审核的商品，并且下单，并且不要支付. （2）将订单号复制到输入框，并且点击绑定，如下图所示.   [图片][图片]   （3）普通订单关联后在小程序进行微信支付后，在后台订单列表进行发货，收货完成，退款关闭等操作。关闭退款操作可直接在后台点击“退款并关闭订单”，如下图所示. [图片]   注意：通过后台点“退款并关闭订单”，若提示“未上传完整的微信支付证书，请到系统设置--支付方式中上传!” 处理方法：重新上传小程序微信支付CERT证书文件、KEY密钥文件，路径如下 [图片][图片]   （4）二级商户订单关联后需要在小程序进行微信支付后，在后台订单列表进行发货，收货完成，售后审核，退款关闭等操作。二级商户订单，可以在微信--视频号--订单--售后退款--进入页面点退款（二级商户订单退款，实际上是模拟前端申请退款）。如下图所示. [图片][图片][图片][图片]   （4）物流接口调用 对上述关联绑定的订单，在后台点击确认发货(可以填写真实快递单号和公司，也可以随便填写)，确认收货。 [图片]     （5）售后接口调用   如上 订单接口调用 的步骤，测试绑定关联的订单有进行退款操作即可. [图片]   (3)(4)(5)接口调用步骤完成，便可在小程序后台--交易组件--组件接入，点击完成. [图片]   注意要完成，否则提示“检测到你未完成此项步骤，请确认后重试”，如下图所示. [图片]   4、发布小程序   自定义交易组件新接口适配功能是2022年4月29号下午约15:00发布上线的，站点注意更新最新，上传最新小程序代码，完成了小程序代码的发布和上线! [图片]     5、完成组件接入 [图片]   （四）申请场景接入   前往小程序微信公众平台中，进入“交易组件”>“场景接入”菜单中，查看并选择需要接入的场景，微信官方默认所有场景均可接入. [图片]   1、视频号   （1）视频号推广：开通需要微信审核，一般2个工作日可以申请下来，具体以微信审核时间为准。添加一个视频号为推广员，然后就可以在这个视频号关联到已经开通自定义交易组件的小程序，关联后就可以上架已经商品同步接口调用通过的商品了。   视频号关联小商店/小程序： https://developers.weixin.qq.com/community/business/doc/000ce0f5014a186f871bf21b459c0d   视频号直播关联小商店/小程序 https://developers.weixin.qq.com/community/business/doc/000ce8f5688b4873a72b2d6c15ac0d   [图片] [图片]   （2）直播间分享员：开通无需审核。 直播间分享员说明 >>https://developers.weixin.qq.com/community/business/doc/000804f4248538558facd4fff5f40d       [图片][图片] 2、订单中心   开通能力后：可增强订单曝光和小程序留存，在「微信」-「发现」-「小程序」-「我的订单」看到订单同时收到订单变更的消息. 查看指引>>https://docs.qq.com/doc/DUnlGcXVWREREelpV   [图片][图片] 五、商城后台 -- 自定义交易组件配置 （一）基础设置（接入组件）程序会判断当前小程序是否已经接入自定义交易组件，如果未接入，在接入状态处会有“申请接入”按钮，点击会申请开通自定义交易组件。   [图片]   已接入状态如下 [图片] 1、订单接入 如上面 "小程序官方后台 -- （三）开通自定义交易组件 --3、组件接入 -- 订单接口调用" 说明. 2、售后地址 用于流程走不通时让微信返回报错信息。 [图片] 3、商户信息 [图片] （二）类目审核列表（同步类目至微信审核） 微信那边个别类目需要审核，这边可在类目审核列表--点击申请 [图片] 选择商品分类根绝所需资质证书提示上传资质材料和营业执照 [图片] 提交后，等待审核可查看类目名称、审核单号、营业执照和资质材料 [图片] 审核通过了 显示如下 [图片] （三）同步商品至微信审核   1、微信商品列表—新增（上传商品） （1）点击微信商品列表 （2）点击右上角新增[图片]   （3）选择商品分类，该分类为微信官方的商品分类，与商城商品分类无关，部分需要审核才能开启的分类会被隐藏，点击更新分类可以从微信官方同步分类数据到本地。（目前只支持选择商城自营商品，其他商品类型将逐步支持） [图片] （4）选择分类后，如果该分类需要提交商品资质证明，会出现提示。   [图片] （5）选择商品，一次最多选择10个商品，如果该分类需要商品资质证明，在商品列表会出现商品资质按钮（商品资质图片默认取上一次审核时提及的图片），点击后选择图片并上传。 （6）点击提交，系统会自动获取商品数据并且提交审核。 （7）提交完毕后会跳转到审核列表。 [图片] 2、商品审核列表 （1）商品审核列表会显示提交的审核记录和审核状态等信息。 ① 点击查看数据：可以看到提交审核时上传的数据信息：名称，分类，图片，审核状态，时间，规格。 （审核一般数分钟到十几小时都有，商品审核会有审核结果回调，但是回调只有一次请求容易漏掉，所以可以直接点击同步按钮更新所有未完成的审核。） ② 点击取消审核:会取消当前正在进行中的审核。 ③ 点击重新提交：会进入该商品的提交页面，提交的商品数据以当前商城数据为准。（审核期间，线上商品信息依然是审核前的状态） [图片]   （四）线上商品列表 1.同步：获取微信端数据，更新本地的商品数据 2.新增/上传商品：跳转到商品上传页面，如果是上传商品，会默认带上选择的商品和分类 3.查看数据：查看商品数据详情，此处的商品数据会实时从微信端获取最新数据并且更新当前商品 4.审核详情：查看该商品最新的一次审核的情况 5.删除商品：删除微信端的该商品，同时删除该商品的审核记录。 6.商品状态： ①初始：新的商品刚刚提交审核，并且还没有通过审核或者审核被驳回 ②自主下架：通过审核后的商品自行下架 ③上架：通过审核后的商品上架中 ④风控/违规下架：被微信端下架 7.点击商品名可以跳转到商品编辑页面 [图片][图片] （五）特别注意 ①要将订单同步到微信，需要上传规格，如果在商城规格与线上商品规格不一致的情况下，会出现同步失败的问题。所以进行视频号直播带货前请确认微信端与本地商品规格信息一致。   ②从微信视频号进入小程序时，只能购买已经同步到微信端的商品，其他商品如果下单后使用微信支付，会出现下单/调起支付失败的问题。出现这种情况需要重新进入小程序才可以正常购买其他商品   ③只有在视频号进入小程序后下单支付并且使用微信支付的订单，才会同步到微信端。如果使用其他支付方式、长时间未支付或在其他端支付，可能导致同步失败。     六、日常问题   Q1、小程序开通了交易组件的商户号，是否要把商户号信息填到商城小程序微信支付里？ A1：不需要，小程序还是按照原先配置的支付信息。视频号场景需要申请商户号作为场景经营使用的资金账户，仅用于视频号商品订单微信支付资金进入该账户，可以通过这查看流水详情。 [图片][图片]   Q2、新版交易组件需要重新申请商户号吗？是否可以使用原有商户号？ A2：不可以，新版交易组件必须要申请开通场景专用商户号 Q3、新版场景专用商户号费率是多少，是否有优惠，结算周期是多久？ A3：商户号费率为0.6%，无费率优惠，结算周期为7+7日，即用户收货后7天后结算。 Q4、视频号橱窗管理获取不到对应小程序 A4：检查是否开通视频号场景；2、检查是否绑定了推广员（非小程序超管需要绑定推广员）   Q5、绑定普通订单、二级商户订单，有先后顺序的吗，可以先绑定二级商户订单吗？ A5：可以，没有先后顺序，2种类型有绑定即可.   Q6、怎么看测试订单有没有绑定成功呢？ A6：先进小程序商城拍下已审核商品，注意不要付款，后台绑定订单后，再在进小程序商城完成微信支付，订单将展示在「微信」-「发现」-「小程序」-「我的订单」,如下图 [图片][图片]     Q7、绑定二级商户订单，进入小程序完成支付，怎么提示“获取支付参数失败，错误码40164:invalid ip...” A7：小程序ip白名单没配置，可登录小程序平台mp.weixin.qq.com -- 开发 -- 开发管理 -- 开发设置 -- 开发者ID -- 添加ip白名单（ip地址为您的服务器ip），添加后，再进入支付便可正常。 [图片]   Q8、二级商户订单前端微信支付提示提示“获取支付参数失败，错误码1010043:当前订单状态不允许...”？ A8：一般这情况原因是小程序没配置ip白名单，也没启用配置消息推送。启用配置说明看上面“第四大点的第（二）点：启用和配置消息推送” [图片]   Q9、没接入公众号（服务号），只接入小程序，还能配置消息推送吗？ A9：可以。依旧是在商城后台 --  应用  -- 公众号  -- 复制服务器地址（URL）、令牌（Token）、消息加密密钥（EncodingAESKey）粘贴到小程序的消息推送处。 [图片][图片] [图片]     Q10、通过视频号转发购买商品，是否能锁客？ A10：不是通过商城里分享的都无法锁客。   Q11、添加视频号推广提示“请检查视频号主体是否与本小程序一致” A11：检查 [图片]   Q12、只要添加成推广员，是不是代表推广员这个账号已经和小程序完成了绑定，直接在直播的商品带货中添加小程序的商品即可？还是说需要额外的什么流程或者业务？ A12：是的，没有其他额外流程。   Q13、小程序自定义交易组件一天能添加几个视频号推广员？ A13：避免被人滥用，目前只能一天主动搜索10次。   Q14、接入测试订单提示商品规格异常。 A14：修改过商品规格后没有重新上传商品到微信，重新上传试试看. [图片]

自定义交易组件 本文主要介绍新版自定义交易组件的业务流程及各流程的注意事项，文档篇幅较长，如无需查看完整文档可以使用浏览器自带页面搜索功能进行关键字搜索（快捷键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.订单已进行部分退款 码字中 稍后回来

 什么会报Cannot find name 'wx'？

你好，     开发中遇到使用windows电脑版微信的内置浏览器出现白色，但是在其他浏览器均显示正常，请问电脑版微信内置浏览器如何调试？PS：在Mac版的微信内置浏览器可以打开

文档地址：扣费服务 Q1:商户调用【申请扣款】接口返回"err_code:RULELIMIT,err_code_des:交易金额或次数超出限制，请检查后再试"是什么原因？ A1:商户扣款时超出了模板id配置的最大扣款金额或次数，如有需要可以联系微信运营申请提升额度或次数。 Q2:申请扣款周期说明 A2:请参考以下几点： 自动续费周期一般是以月、季度为周期，具体扣款发起时间不受模版内容的周期影响；委托代扣额度初始额度：单笔500、单日2500；授权扣款和免密支付，在额度限制内可以每天扣款5次（同一个用户在一个签约协议下；扣款失败不计算次数）；自动续费模版需要按模版内容设定的周期扣款，且同一个用户在一个签约协议下每天仅可以扣款一次，如上线前需多次测试签约扣款，请申请测试模版（模版名称标明为测试，测试模版限额为每次0.1元，每天可扣款100次）。 Q3:签约和解约信息是通过什么路径通知给商户的？ A3:签约通知是通过签约接口上传的notify_url参数所填写的地址回调通知的（签约失败不通知）。解约信息是通过创建模版ID时填写的解约通知URL来回调通知的。 Q4:申请扣款接口已经返回成功，为什么还会扣款失败？ A4：申请扣款接口返回成功仅代表申请受理成功，不代表最终的扣款结果，扣款结果应以支付结果通知接口通知的结果为准，无论扣款是否成功都会返回扣款结果及原因。 Q5:商户调起微信纯签约报错“参数构造错误”如图，是什么原因？ [图片] A5:检查下文档要求的必填参数有没漏传，或者文档中没有的参数有没多传。 Q6:商户调用H5纯签约返回“签约参数签名校验错误”是什么原因？ A6:请参考以下几点： 检查下签名是否正确，商户签名使用的key是否正确，并且key用的是api秘钥，不是apiv3秘钥,签名方式和api秘钥设置路径参看文档指引，商户可以用在线工具自行校验，工具地址；检查下商户传的notify_url参数文档是否有要求encode，如文档要求encode，则商户签名时需要使用encode之前原样的notify_url进行签名，encode只需一次即可。检查下文档要求的必填参数有没漏传，或者文档中没有的参数有没多传。 Q7:委托委托代扣模板id停用后会有什么影响？ A7:已签约用户可以继续扣费或解约，不能新增签约，停用模板id后无法恢复使用，商户自行评估风险 Q8:公众号纯签约跳转签约页面后用户点击开通自动续费没反应是什么原因？ A8:引导用户更新一下微信或清除下微信缓存，这种一般是偶现的，杀死进程重新启动再试试。 Q9:商户使用预扣费通知模式场景下，对于没有发送微信预扣费通知的用户，商户调用申请扣款接口后，微信端会返回什么错误？ A9:接口会返回错误码INVALID_REQUEST，商户需要先下发扣费前通知才能发起扣费，若当前签约扣费期已结束，商户如需扣费则需重新发起扣费前通知。 Q10:商户从24小时扣费模式迁移到预扣费通知模式阶段时，发送预扣费通知后，解约后重新签约，可直接进行扣款，不受扣费等待期限制，这样是正常的吗？ A10:正常的，用户解约后就是新的协议了，预扣费通知限制的维度是协议，没有发送过预扣费通知的协议，可以走直接扣费模式，发送过预扣费通知的协议，走预扣费通知模式，商户在迁移阶段，只有两种模式可以扣：预扣费通知模式和直接扣费模式，商户完成迁移后需联系微信侧运营确认，微信侧运营则会通知业管同事在系统中操作“迁移完成”，之后商户就只能走预扣费通知模式了。 Q11:预扣费通知中的错误码“RESOURCE_ALREADY_EXISTS”和“INVALID_REQUEST”的错误码描述意思是一样的，“RESOURCE_ALREADY_EXISTS”错误码描述为：已经下发过预扣费通知，请勿重复下发，“INVALID_REQUEST”错误码描述为：已经发送过扣费前通知，需要等本次扣费完成后再发起新，有什么区别吗？ A11:错误码“RESOURCE_ALREADY_EXISTS”表示是相同参数，重复发送，错误码“INVALID_REQUEST”表示是发送过，参数不一样。错误码“RESOURCE_ALREADY_EXISTS”可以认为是发送成功。错误码“INVALID_REQUEST”可以认为是发送失败。 Q12:一个微信用户能否与商户多次签约？ A12:签约遵循同一个商户号+同一个模版ID+同一个微信号只能签约一次的原则。多次签约可采用多模版ID的方式，同一个商户号下的每个不同模版ID都可以与同一微信用户分别签约一次。 Q13:委托代扣解约回调地址修改后多久生效？ A13:实时生效 Q14：商户使用微信支付商户平台发起的解约，收到的解约回调里的协议解约方式是3（商户API解约）这个是正常的吗？ A14:正常的，目前微信支付商户平台就是调用商户API解约的。 Q15:商户调起微信纯签约报错“签名参数构造错误”如图，是什么原因？ [图片] A15：请参考以下几点： 检查下签名是否正确，商户签名使用的key是否正确，并且key用的是api秘钥，不是apiv3秘钥,签名方式和api秘钥设置路径参看文档指引，商户可以用在线工具自行校验，工具地址；检查下商户传的notify_url参数文档是否有要求encode，如文档要求encode，则商户签名时需要使用encode之前原样的notify_url进行签名，encode只需一次即可。 Q16:支付中签约是否支持传入分账标识实现订单分账功能？ A16：暂不支持，支付中签约下单接口不会识别商户分账标识 Q17:单用户在单模板下商户尝试调用申请扣款接口的频率是多少？ A17：单用户在单模板下商户尝试调用申请扣款接口一天不能超过默认次数300次（包含succee和fail的返回，succee才表示扣款受理成功，等待扣款中） Q18:app纯签约点击完成后没有返回app而是停留在了微信聊天界面？ A18: 商户登录开放平台检查对应app应用是否有跳转权限[图片] 2.按照文档排查下是否正常处理回调，参看文档https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Access_Guide/Android.html（注意：taskAffinity要填你的应用主taskAffinity（其实就是主界面的task，如果没有主动配置的话，默认是应用包名，如果要配置的，要改成跟配置的一样） [图片] 3.商户检查申请模板时的模版名称中是否有空格，如有只能删除模版名称中的空格后重新申请模板 [图片] 4.商户检查用户账户展示名称参数contract_display_account是否有空格，中英文符号，特殊字符串 Q19:app纯签约签约完成后，点击完成按钮，android点击没有反应，iOS点击提示“离开微信”，随后提示"未安装应用"? A19:请参考以下几点： 检查下商户传的appid是不是签约的这个app的appid检查返回的appid对应的app是否有安装检查商户的app是否有在手机注册schema地址 Q20:h5纯签约签约完成后点击完成按钮返回浏览器报错"launchApplication:fail_url need encode"？ [图片] A20：原因：商户请求签约的原url，里面参数嵌套了其它url地址，所以导致微信侧回跳的时候，解析错误了。这里面failUrl和redirectUrl虽然做了encode，但是由于微信侧回跳前会做一层decode，所以decode之后的链接是一个非法链接，被拦截了。如果商户需要嵌套url地址，可以做两层encode试试，建议解决方式：剔除参数中嵌套的url。 Q21:Url Schema指的是什么，UA指的是什么？ A21: url schenma指的是app页面跳转协议地址UA指的是浏览器的User Agent，会跟随HTTP协议的header传递 Q22:app纯签约接口是否支付多账号签约功能？ A22：支持，商户只需在app纯签约中的预签约接口里多传入outerid字段即可，参数值格式必须按照此示例：李*艳（00000000000），否者会报错"<xml><return_code><![CDATA[FAIL]]></return_code><return_msg<![CDATA[PARAMERROR:outerid]]></return_msg></xml>" Q23:多账号签约接口里的contract_outerid和outerid的长度限制分别是多少？ A23：contract_outerid32位字符，outerid32位字符 Q24:公众号纯签约商户的短链接可以跳转到签约页面，商户的长链接跳转报502是什么原因？ A24：链接超长，目前链接长度限制在1024字节以内 Q25:已签约同个模板id的用户使用支付中签约有已签约的提示吗？ A25：支付中签约一直都没有已签约的提示,纯签约会有提示 Q26:使用签约协议号A已签约后再解约，后续还可以使用签约协议号A签约成功吗，对吗？ A26：目前是这样的 Q27:商户调用支付中签约生成的订单使用的查询订单和支付回调结果通知是哪个文档？ A27：支付中签约生成的订单使用普通支付的查询订单接口(文档地址:https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_2)和普通支付的支付结果回调通知接口(文档地址:https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_7&index=8) Q28:开通多账号签约功能的模板id，如果同一个微信签约了两个用户，那么模板id扣款次数限制规则是不是应该按两个不同的签约用户分开计算 A28：是的，针对每个签约独立计算 Q29:同个微信号在同个模板下当天有扣款次数限制吗？ A29：同个微信号在同个模板下当天最多能扣150次，总共包含商户重试申请扣款失败的次数和申请扣款成功的次数 Q30:商户调用申请扣款接口报错“扣款请求已受理，请勿重复发起” A30：据自动续费规则，一个协议ID，在等待期间（24小时内），只能有一笔扣款 Q31:h5纯签约ios拉起签约后点击左上角返回的是微信，Android拉起签约后点击左上角返回的是拉起的签约页面，这是正常的吗 A31：这是正常的，Android 能返回是因为只拉起WebView界面，结束之后把WebVIew关了，然后就漏出了浏览器，iOS做不到只拉起WebView界面，结束之后只能到聊天页面 Q32:h5纯签约签约完成后点击完成按钮返回的是商户首页（域名），不是发起签约请求的页面 A32: 1.浏览器发起签约场景： 问题根因：referer由于客户端webview内核安全策略变更，需要源页面进行授权后，才能获取完整URL，否则无法在签约完成后，原路跳回商户的H5页面，浏览器由于兼容性问题导致微信侧获取的referer只有域名部分，丢失了path部分，所以返回的是商户域名页 微信支付侧协助寻找了以下解决方案，建议商户试试，如仍有问题需商户自行联系浏览器厂商处理： 商户跳转前的源H5页面，需要在html中做referrer-policy的授权声明： 方法一（推荐）： <meta name="referrer" content="no-referrer-when-downgrade">> 方法二： <meta name="referrer" content="unsafe-url"> 安全策略详情可参考：https://developers.google.com/web/updates/2020/07/referrer-policy-new-chrome-default Referrer-Policy声明的用法可参考：https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Headers/Referrer-Policy 注意： ① 商户需要检查一下html里面是否有多个meta name="Referrer"的声明（比如声明了一个<meta name="Referrer" content="origin" />，会覆盖开头的声明，需要删掉） ② 检查发起签约页面跳转微信时是否有处理过（比如中转页面或着在后台跳转的），必须是商户前端发起的跳转，否则不会生效 ③由于iOS15对referrer policy更加严格，referer只带了host没有带path，但iOS14以及之前版本的referer带了host和path，导致了iOS15以上目前只能返回商户域名页面 2.商户发起签约页面地址中有片段标识符： 片段标识符（URI Fragment，即URL中#号后面的部分）仅用作浏览器端的处理，不会参与到服务端请求中，故签约完成回跳不会带上这部分信息。 Q33:app内嵌h5纯签约无法唤起微信的签约页面是什么原因？ A33：建议检查拉起微信的app是否有拒绝打开授权，历史上的case都是用户自己拒绝了唤起授权。 Q34:商户使用申请扣款（pay/pappayapply）下单成功后，再调用关单接口（/pay/closeorder）成功后，之后再使用代扣的查询订单接口（/pay/paporderquery）查不到这笔订单，报错”订单不是委托代扣场景“，目前有什么解决方式吗？ A34：商户可以使用基础支付的查询订单接口来确认订单状态。 Q35:商户app内嵌h5发起h5纯签约签约完成后，申请了返回app的权限，返回app时提示“launchApplication:fail”，是什么原因？ A35：原因是商户配置的app的Schema有误导致无法正常跳回app，商户可以联系app的开发人员检查下操作系统中是否有注册这个Schema以及配置的appid是否正确。  Q36:商户调起微信纯签约报错“商家系统错误，请联系商家处理”如图，是什么原因？ [图片] A36：请参考以下几点： 检查下签名是否正确，商户签名使用的key是否正确，并且key用的是api秘钥，不是apiv3秘钥,签名方式和api秘钥设置路径参看文档指引，商户可以用在线工具自行校验，工具地址；检查下商户传的notify_url参数文档是否有要求encode，如文档要求encode，则商户签名时需要使用encode之前原样的notify_url进行签名，encode只需一次即可。检查下文档要求的必填参数有没漏传，或者文档中没有的参数有没多传。h5纯签约的情况需要特殊申请权限，联系对接的运营咨询检查request_serial(请求序列号)或timestamp(时间戳)是否为int类型，是否小于9位

自动续费周期一般是以月、季度为周期，具体扣款发起时间不受模版内容的周期影响。委托代扣额度初始额度：单笔500、单日2500、单月75000； 2.1授权扣款和免密支付，在额度限制内可以每天扣款5次（同一个用户在一个签约协议下；扣款失败不计算次数）；自动续费模版需要按模版内容设定的周期扣款，且同一个用户在一个签约协议下每天仅可以扣款一次，如上线前需多次测试签约扣款，请申请测试模版（模版名称标明为测试，测试模版限额为每次0.01元，每天可扣款100次）。 更多委托代扣相关问题可查阅：委托代扣接口常见问题Q&A

微信支付沙箱环境怎么没介绍呀

开发测试，企业微信小程序应用 code2Session 一直表现很正常，昨天开始 返回的  userId corpid 不对了，没有报错 企业微信小程序调用 wx.qy.login() 获得 js_code 后，调用接口：https://qyapi.weixin.qq.com/cgi-bin/miniprogram/jscode2session?access_token=ACCESS_TOKEN&js_code=CODE&grant_type=authorization_code 返回：{"userid":"woRlahEAAAxUjVpyJz2VSlQL1dxg8fzg","session_key":"q3btt+KRtH3WVyW/31YSrw==","corpid":"ww93facc909786e5c7","deviceid":"","errcode":0,"errmsg":"ok"} userid、corpid 都不对了，前天还正常的

在企业微信拉新时，由于企业微信免验证规则限制（免验证设置后必须通过联系我二维码扫码才能实现双向客户关系），经常出现用户扫码后是单向客户关系，而工作人员认为自动免验证加入，出现对用户的服务不到位，被用户拉黑或删除的情况，导致潜在客户的流失。 对出现单向客户关系，解决方法如下： 一、企业微信改变规则 在设置“加我为联系人需要验证”设置禁用后，给用户出示联系我的二维码（外部客户添加时是否无需验证字段skip_verify设置为true，默认为true），才能实现双向客户关系。 在运营工作中，由于各种原因，工作人员为用户出示的是“请加我的企业微信”中的二维码，导致单向出现客户关系，如果工作人员不去确认添加，就成为了真正的单向关系；  解决建议：企业微信官方改变规则，只要设置“加我为联系人需要验证”设置禁用后，不管用什么二维码扫码，默认都自动通过，不需确认。 二、教育员工正确使用免验证 由于第一条中的原因，在官方未改变规则的情况下，避免出现单向客户关系的最好办法，就是教育员工，设置免验证后，必须使用客户联系，联系我，通过二维码联系生成的二维码。 事实上，我们运营过程中经过多次教育，仍存在单向客户关系： 1、前期分享出去的二维码； 2、渠道下的人员众多，某些人未更换二维码； 3、新的渠道加入； 4、渠道执行不到位; …… 三、出现单向客户关系时的实时提醒 企业微信原生功能对出现单向客户关系时没有任何提醒，但我们可以借助企业微信提供的强大API接口，实现出现单向客户关系时的实时提醒，如下图所示（在企业微信自建应用中的消息）： [图片]  实现方法及过程： 1、处理外部联系人免验证添加成员事件add_half_external_contact，获取EXternalUserID(openid)及UserID;  [图片] 2、给员工(UserID)发送应用消息通知【文件卡片消息】,消息中包括聊天测试链接，调用创建会话接口，进入用户单聊界面； 在员工未找到消息添加的情况下，点开卡片消息，进入聊天测试，提示：无法与非外部联系人发起聊天。 [图片]   如到消息提示的时间找到外部客户，添加后，再进入聊天测试，如下提示后，然后就可以进入会话，与客户正常联系：  [图片] [图片]

企业微信用户能与企业微信绑定的小程序里面的用户实时聊天吗？

目前只会PHP技术，是否可以提供会话内容存档PHP的SDK呢？ 有没有已经用PHP对接成功会话存档API数据呢？

需要在第三方平台添加“附近”权限集，全网发布，获得用户授权才可调用附近小程序相关接口： 附近接口文档：https://docs.qq.com/doc/DWHlwZ0ZPellkQVh3?opendocxfrom=admin   

各位微信开发者： “小程序直播” 功能正在公测中，目前已支持服务商接入。 服务商申请权限之后，可帮助商户快速实现小程序直播功能。 功能简介 “小程序直播” 是微信官方提供的商家经营工具。符合接入要求的商家，通过直播组件，可以在小程序中实现直播互动与商品销售的闭环。 商户准入要求 满足以下条件的电商平台、自营商家，即有机会被邀请到小程序直播公测中来： （同时满足以下1、2、3条件，加上4、5、6条件的其中之一即可。） 1. 属于小程序直播开放类目，具体见《微信小程序直播功能准入要求》 2. 主体下小程序近半年没有严重违规 3. 小程序近90天存在支付行为 4. 主体下公众号累计粉丝数大于100 5. 主体下小程序近7日dau大于100 6. 主体在微信生态内近一年广告投放实际消耗金额大于1w 服务商接入指引 具体接入指引请参考《【小程序直播】服务商接入指引》，以下为服务商接入步骤。 1. 权限申请 1） 在问卷《服务商“小程序直播”接入申请》填写相关信息并等待权限开通，发送申请后7个工作日内，可登陆微信开放平台查看第三方平台权限集并勾选 “小程序直播” 能力； 2） 开通后，即可登陆 “微信开放平台” （open.weixin.qq.com）勾选 “小程序直播” 第三方权限集并全网发布； 2.功能开发 小程序直播需要实现【直播组件】与【后台API】两个部分，其中组件部分需要在小程序中进行配置开发。 具体开发文档，请参考《小程序直播组件接入指引》。

急急急 在企业微信关联的小程序中创建会话成功后，点击左上角返回按钮不能正常返回小程序。企业微信是否支持从聊天界面点击返回时返回对应小程序 [代码]wx.qy.openEnterpriseChat({[代码][代码]               [代码][代码]// 注意：userIds和externalUserIds至少选填一个，且userIds+openIds总数不能超过2000。[代码][代码]               [代码][代码]userIds: userid,    [代码][代码]//参与会话的企业成员列表，格式为userid1;userid2;...，用分号隔开。[代码][代码]               [代码][代码]externalUserIds: [代码][代码]''[代码][代码], [代码][代码]// 参与会话的外部联系人列表，格式为userId1;userId2;…，用分号隔开。[代码][代码]               [代码][代码]groupName: [代码][代码]'讨论组'[代码][代码],  [代码][代码]// 必填，会话名称。单聊时该参数传入空字符串""即可。[代码][代码]               [代码][代码]success: [代码][代码]function[代码] [代码](res) {[代码][代码]                   [代码][代码]console.log([代码][代码]'会话调起成功'[代码][代码], res);[代码][代码]               [代码][代码]},[代码][代码]               [代码][代码]fail: [代码][代码]function[代码] [代码](res) {[代码][代码]                   [代码][代码]// 失败处理[代码][代码]                   [代码][代码]wx.showToast({[代码][代码]                       [代码][代码]title: [代码][代码]'会话调起失败'[代码][代码],[代码][代码]                       [代码][代码]icon: [代码][代码]'none'[代码][代码]                   [代码][代码]});[代码][代码]                   [代码][代码]console.log([代码][代码]'会话调起失败'[代码][代码], res);[代码][代码]               [代码][代码]},[代码][代码]               [代码][代码]complete: [代码][代码]function[代码] [代码]() {[代码][代码]                   [代码][代码]console.log([代码][代码]'complete：调用完成'[代码][代码]);[代码][代码]               [代码][代码]}[代码][代码]           [代码][代码]});[代码] [图片] [图片]