本文不在更新,请看新版自定义交易组件接入指引
看帖不点赞,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、检查是否绑定了推广员(非小程序超管需要绑定推广员)
持续更新中~~~
新版交易组件,是不是走了电商收付通的模式?
大佬,问一下客服消息发送后台看不到是什么原因呢/
使用自定义组件开通小商店,在视频号直播时,点击右下角的商品图标,在直播间购买商品,为什么在“视频号—订单中心”查不到订单信息,但是在“小程序—我的订单”里能查到订单信息呢?
大佬 问一下 就是在视频号售后里发回退件后 怎么把物流信息同步到我们自己的系统里 获取售后详情时没有物流信息
大佬,针对 q9说明 售后退款金额不能包括运费。【1.请检查“orderamt”参数,传参金额应不含邮费。】
自测appId wxd1e2e86707135b11 aftersale_id: 4000000001676005 退款是可以包括运费的。(自测了另外一个appId也是可以的)
但是有一些appId,退款金额包括了运费,调用【生成售后订单】时,返回了 {"errcode":2747014,"errmsg":" 售后金额不合法,大于最大可退款金额 rid: 6267aa65-578c5502-71d827c7"},定位不到什么问题
那这个售后单是 仅退款而已,但是退款金额包括了运费就报以下错误了,是bug还是规则如此呢? [试了一下不包括运费就成功了]
"result": {
"errcode": 2747014,
"errmsg": " 售后金额不合法,大于最大可退款金额 rid: 62681572-392207b8-56974738"
},
重现到是【订单发货】后,仅退款就不能包括运费。
请问视频号订单中心,待发货订单这里申请退款为什么点击没反应?但是退款中的订单同样颜色的字体就可以点击进去.是需要配置什么信息么?
订单号: 2022042611390855300015210298
大佬 问一下 新版交易组件 售后是没有换货状态的吗?
获取售后详情,返回值中的product_info ,每个售后单中只有一个sku吗(意思是视频号推送的售后单是按照sku生成售后单的,同一个sku一个售后单) https://api.weixin.qq.com/shop/ecaftersale/get { "errcode": 0, "errmsg": "ok", "after_sales_order" : { "out_aftersale_id" : "aso_123124341", "aftersale_id": 123, "out_order_id" : "order_312312", "order_id": 456, "product_info" : { "out_product_id" : 123, "out_sku_id" : 12345, "product_cnt" : 1 }, "type": 1, "return_info" : { "order_return_time" : "1628480465", "delivery_id" : "sf", "waybill_id" : "sf12314789", "delivery_name" : "顺丰" }, "orderamt": 100, "refund_reason_type" : 1, "refund_reason" : "买错码数", "status" : 1, "create_time" : "1628480465", "update_time" : "1628480465", } }
请问,新版自定义交易组件,因为类目和商品上加了“商品使用场景”字段,并且为必填项。 我们在做好优化之后,是不是要重新依次提审类目和商品?? 不重新提审的话类目和商品是否可以正常使用?
视频号自定义交易组件 wx.requestOrderPayment 场景值1175的时候能调起来 1177的时候报未知错误 1177不能调用wx.requestOrderPayment吗
{
"errcode": 0,
"order": {
"order_id": 3302740749631750912,
"out_order_id": "100259_966382764945674240",
"openid": "omigo5XCEGQS5loJFZHNkwnn2ROg",
"create_time": "2022-04-20 17:00:06",
"order_detail": {
"product_infos": [
{
"product_id": 420329451,
"out_product_id": "38491",
"sku_id": 382201427,
"out_sku_id": "61532",
"product_cnt": 1,
"sale_price": 2,
"title": "黑人(DARLIE)炭丝高密牙刷4支 软毛牙刷 炭丝刷毛 小刷头 纳米炭刷毛 抑菌刷毛",
"head_img": "http://img13.360buyimg.com/n1/jfs/t1/90384/5/11703/323158/5e3a992bE0bb39338/e5d3d1e1d8ca8fe3.jpg",
"path": "pages/goods/goods-detail?id=38491",
"sku_attrs": [],
"sku_real_price": 2,
"can_after_sale": false
}
],
"pay_info": {
"prepay_id": "wx2017000753667882d064d4c6a7cc860000",
"prepay_time": "2022-04-20 17:00:07",
"pay_method_type": 0,
"out_trade_no": "120330274074963175091200000"
},
"price_info": {
"freight": 0,
"discounted_price": 0,
{"errcode":0,"order":{"order_id":3302740749631750912,"out_order_id":"100259_966382764945674240","openid":"omigo5XCEGQS5loJFZHNkwnn2ROg","create_time":"2022-04-20 17:00:06","order_detail":{"product_infos":[{"product_id":420329451,"out_product_id":"38491","sku_id":382201427,"out_sku_id":"61532","product_cnt":1,"sale_price":2,"title":"黑人(DARLIE)炭丝高密牙刷4支 软毛牙刷 炭丝刷毛 小刷头 纳米炭刷毛 抑菌刷毛","head_img":"http://img13.360buyimg.com/n1/jfs/t1/90384/5/11703/323158/5e3a992bE0bb39338/e5d3d1e1d8ca8fe3.jpg","path":"pages/goods/goods-detail?id=38491","sku_attrs":[],"sku_real_price":2,"can_after_sale":false}],"pay_info":{"prepay_id":"wx2017000753667882d064d4c6a7cc860000","prepay_time":"2022-04-20 17:00:07","pay_method_type":0,"out_trade_no":"120330274074963175091200000"},"price_info":{"freight":0,"discounted_price":0,"final_price":2,"order_price":2},"pay_info_list":[],"promotion_info":{}},"delivery_detail":{"delivery_type":1,"delivery_list":[]},"status":10,"update_time":"2022-04-20 17:00:07","address_info":{"receiver_name":"测试","detailed_address":"福建省福州市长乐区测试","tel_number":"18094151170","province":"福建","city":"福州市","town":"长乐区"},"scene":1177,"out_user_id":"10011153","fund_type":1,"expire_time":1650447006,"aftersale_duration":5}}