评论

新版交易组件接入的指引与Q&A(本文不在更新,看文章内新地址)

如有对接入流程有疑问可在社区发帖咨询或留言回复说明问题。注:跟帖回复不描述清楚详细问题不回复

本文不在更新,请看新版自定义交易组件接入指引

看帖不点赞,bug千千万

需要先申请开通“交易组件场景专用商户号”才可以完成新版交易组件场景接入(申请场景经营商户号这是必要条件),进行接入时一定要按照文档流程顺序进行接入,不要新旧接口混合调用,否则无法正常跑通完整流程,切记!切记!切记!

先配个图证明新版接入已完成

有新问题可以留言,有准确答案(方案)后补充更新

一、升级版自定义交易组件接入说明

1、组件介绍

若商家此前已经完成视频号接入小程序,在小程序中调用升级版自定义交易组件组件后,可在保留原有的界面、功能及交易链路的情况下接入微信视频号场景。通过调用商品上传、订单生成、状态同步等接口,实现在视频号场景中交易资金流、售后、交易纠纷、客服等能力的标准化。

2、功能特点

  1. 可在视频号场景实现商品展示和带货等功能
  2. 未来可支持更多直播营销玩法(券、 秒杀、预售等)
  3. 支持小程序客服组件,商家能更方便收到用户的客服咨询
  4. 订单中心显示更完善的订单信息,用户可自行查看订单状态
  5. 支持用户在视频号订单中心继续付款、发起售后

3、上线案例

  • 升级版自定义交易组件为商户提供保障用户体验的直播电商全链路能力:
  1. 可以使用微信支付商户号,资金结算更规范。
  2. 小程序和视频号的订单进行了双向打通,用户可以任选在小程序或视频号订单中心处理订单,例如重新发起支付、确认收货等,大大提升用户体验。
  3. 通过打通小程序客服组件,增强了商家处理商品咨询的能力。

4、接入流程及官方文档

注意:整个接入流程需要15-30个工作日不等,建议提前准备商品的品牌、资质、类目信息,与开发调试并行,避免延误直播带货计划。
详情见:接入视频号指引

5、关键流程逻辑

  • 注意“橙色”为新加入部分:

二、接入过程中常见问题

有新问题可以留言,有准确答案(方案)后补充更新

Q1:新版交易组件需要重新申请商户号吗?是否可以使用原有商户号?

A1:不可以,新版交易组件必须要申请开通场景专用商户号

Q2:新版场景专用商户号费率是多少,是否有优惠,结算周期是多久?

A2:商户号费率为0.6%,无费率优惠,结算周期为7+7日,即用户收货后7天后结算。

Q3:申请新商户号时,最后一步签约遇到“微信实名信息与管理员信息不一致”是什么原因?

A3:申请新的场景专用商户号时,“超级管理员”这一项不支持修改,默认为小程序“超级管理员”实名信息,如需修改,需要为该用户前往成员管理为小程序绑定超级管理员。

Q4:申请新的商户号时,为什么不能修改主体信息?

A4:“当前主体”这一项不支持修改,因为商户号主体必须和该小程序注册主体保持一致。

Q5:通过新版自定义交易组件申请的场景专用商户号是否对跨境类小程序(自助报关)有影响?

A5:会,二级商户当前暂不支持自助清关接口调用,留意后续更新通知

Q6:自定义交易组件“升级版”跟升级前的自定义交易组件有什么区别,哪些接口需要升级?

A6:

  1. 新支付接口,必须走新商户号。
  2. 取消订单, 小程序(小程序内以及发现-小程序我的订单)和视频号双向可取消,之前只可以在小程序上取消,然后同步给视频号状态。
  3. 申请退款,小程序和视频号双向可申请退款。
  4. 申请退货退款,小程序和视频号双向可申请退货退款,之前只有小程序上操作。
  5. 未付款订单,小程序和视频号 可在各自订单中心重新支付,同步状态。
  6. 确认收货,小程序和视频号双向可确认收货。
  7. 同步发货状态接口更新。

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、检查是否绑定了推广员(非小程序超管需要绑定推广员)

持续更新中~~~

最后一次编辑于  2022-04-14  
点赞 60
收藏
评论

83 个评论

  • 杨鑫
    杨鑫
    2022-06-02

    你好,非二级商户号订单不能调用售后相关接口吗?目前我调用返回的是errcode":48001,"errmsg":"api unauthorized

    2022-06-02
    赞同
    回复
  • 周飞飞
    周飞飞
    2022-05-28

    您好!目前有一个小程序是上线的具备购物的功能,现在需求是需要接入视频号和视频号直播。按照文档已经完成自定义交易组件的开通和视频号的关联。对应的商品也已经添加成功。有几个疑问:

    1、从视频号进入小程序进行下单时,必须要生成订单,并且生成支付参数才能够正常付款吗?不能用原有小程序的下单和支付功能吗?

    2、从视频号进入小程序和原有小程序下单如果区分订单来源?

    2022-05-28
    赞同
    回复 2
    • 周飞飞
      周飞飞
      2022-05-30回复Memory
      谢谢,订单 按照下单前置检查已经区分开。
      还有个问题支付的时候不能用JSAPI进行吗?订单已经创建好,并且调用了支付参数接口也能拿到支付参数。下面的代码和输出值麻烦看看哪里有问题?支付参数接口返回的加密类型是RSA。
      2022-05-30
      回复
    • 周飞飞
      周飞飞
      2022-05-31回复Memory
      谢谢,按照你说的直接调起支付,目前出现 “fail check ticket rejected”这个问题。订单对应的商品状态是审核状态。trace_id值也是每次重现前端获取传到服务端的,除了这些还有哪里有问题?
      2022-05-31
      回复
  • ShUn🐡
    ShUn🐡
    2022-05-26

    请问下非二级商户订单和二级商户订单,使用场景有什么不同?

    未升级交易组件前是没有区分是否二级商户,喔的理解是非二级商户订单,是需要通过api同步订单。那是否升级后,只走非二级商户订单?

    2022-05-26
    赞同
    回复
  • 。
    2022-05-25

    大佬,这些接口使用过postman去调用,还是后端去调用呢?

    2022-05-25
    赞同
    回复
  • 567个小矮人
    567个小矮人
    2022-05-24

    请问现在视频号提现的周期是多久?确认收货后就可以提现么?

    2022-05-24
    赞同
    回复 1
    • 567个小矮人
      567个小矮人
      2022-05-24
      是收货后T+7 还是收货后7+7?
      2022-05-24
      回复
  • 熊
    2022-05-23

    大佬你好:我已有一个接入了标准版交易组件的小程序,和一个视频号,并且已经关联上了。现在视频号在直播的时候,点购物袋能正常显示商品,并且点击商品会跳到小程序的详情页,且后续操作都正常;但是直接点购买按钮,弹窗就会进入白屏加载状态。请问一下这是怎么回事?

    2022-05-23
    赞同
    回复 1
    • 熊
      2022-05-24回复Memory
      好的
      2022-05-24
      回复
  • 0.0
    0.0
    2022-05-21

    大佬,获取售后单列表:https://api.weixin.qq.com/shop/ecaftersale/get_list

    这个接口根据out_order_id查询,报错{"errcode":9700202,"errmsg":"查询订单失败,请检查订单号是否正确 rid: 6287c74e-2edc52d2-27fa7167"}。还有我根据order_id查询,虽然没报错但是返回结果是空的。我用的是同一个售后单的out_order_id和order_id 分开查的,这个售后单也是存在的。

    2022-05-21
    赞同
    回复 1
    • 0.0
      0.0
      2022-05-26回复Memory
      不行,返回的结果是空的没内容 只是不报错
      2022-05-26
      回复
  • 0.0
    0.0
    2022-05-19

    用户在商户小程序中,购买了1个商品(数量是2件),用户在微信侧订单申请退款的时候,是只能一次性申请2件吗?为什么我提交申请就申请了1个,然后查询该售后信息时数量就却是2?是否因为这个问题导致我不能继续提交售后?


    2022-05-19
    赞同
    回复 3
    • 0.0
      0.0
      2022-05-21回复Memory
      https://api.weixin.qq.com/shop/ecaftersale/add?access_token=xxxxxxxxx  这个接口,参数里product_info里的数量填1,生成的售后单信息里数量却是2
      2022-05-21
      回复
    • 0.0
      0.0
      2022-05-31回复Memory
      2022-05-31
      回复
    • 0.0
      0.0
      2022-05-31回复Memory
      这是查询到的售后单信息,提交时候product_cnt是1,生成的售后单信息里product_cnt却是2
      2022-05-31
      回复
  • 赵飞
    赵飞
    2022-05-18

    大佬,小程序自定义交易组件,一直提示 title长度不符合 是什么意思?   名称是在 3 到 60的范围内的~

    ”直播间专属- 双汇-米多面多自热米饭7个口味可选“

    2022-05-18
    赞同
    回复 1
    • 赵飞
      赵飞
      2022-05-20回复Memory
      谢谢大佬~ 确实是编码问题
      2022-05-20
      回复
  • 0.0
    0.0
    2022-05-18

    上架商品,生成订单后数量不会减少是什么? 需要自己调用商品更新接口,去更新库存?还是说缺少了哪个步骤,又或者缺少了什么参数没传?

    2022-05-18
    赞同
    回复 2
    • 0.0
      0.0
      2022-05-21回复Memory
      product_id,sku_id等信息都对得上的
      2022-05-21
      回复
    • 0.0
      0.0
      2022-05-21回复Memory
      https://api.weixin.qq.com/shop/order/add,生成订单的时候sku_attrs这个参数也不用传的,最后生成的订单这个信息和上架商品的sku_attrs完全也对得上,既然生成订单的时候能找到对应的产品信息,那应该没错的吧?
      2022-05-21
      回复

正在加载...

登录 后发表内容