# 交易信息回传接口
回传交易信息(商品、服务、门店),可以提升用户消费评价的体验,还可以通过评价直达商品/服务的落地页。
“交易评价-交易信息回传“ 与 “订阅消息-新版一次性订阅消息Beta” 接口共用 。可以只接入"交易评价信息回传"(A),也可以一次接入实现2个功能(B),详细方法如下:
# A. 想实现“评价能力升级“,暂不接入“新版一次性订阅消息“
如果暂不接入“新版一次性订阅消息“,仅回传交易信息实现“评价能力升级”, 参照“订阅消息-新版一次性订阅消息Beta” 接入,需注意以下2点:
# 1. 激活与更新卡片 setUserNotify
在激活与更新服务卡片时,注意:
content_json中product_list的count、single_price字段需必传content_json中cur_status状态只需传入到“已支付”这个状态
“已支付”状态不会触发订阅消息,仅在微信-发现-小程序tab有红点提示(如下图)。
完成以上2点,即可回传主要交易信息,实现评价能力升级。
# 2. 配置更多服务相关信息setUserNotifyExt
接口更新服务卡片扩展信息,当需要为评价配置更多交易信息时再调用(例如:门店信息、物流信息等)。
调用顺序:先调用上面的主接口激活与更新服务卡片成功后,再调用扩展接口更新服务卡片扩展信息,并传入扩展接口请求参数 ext_json。
ext_json 为扩展信息:不同动态卡片定义不同,可在订阅消息文档中(1.1中各模版定义链接)中查阅,例如:
- 针对有门店的小程序,可在
ext_json中 store_info 传入交易所属门店信息,让评价的内容更有参考价值(如下图)。 - 针对有物流交付的小程序,可在
ext_json中 shipping_list 传入物流消息,让平台邀请用户发表评价的时机更准确。
# B. “评价能力升级“与“新版一次性订阅消息“功能一起接入
如果2个功能都想实现,则按照 新版一次性订阅消息Beta 步骤接入即可,需注意以下2点:
# 1.激活与更新卡片 setUserNotify
在激活与更新服务卡片时,注意:content_json 中 product_list 的 count、single_price 字段需必传。
# 2.配置更多服务相关信息setUserNotifyExt
接口更新服务卡片扩展信息,当需要为评价配置更多交易信息时再调用(例如:门店信息、物流信息等)。
调用顺序:先调用上面的主接口 setUserNotify 成功后,再调用扩展接口 setUserNotifyExt,并传入扩展接口请求参数 ext_json。
ext_json 为扩展信息:不同动态卡片定义不同,可在订阅消息文档中(1.1中各模版定义链接)中查阅,例如:
- 针对有门店的小程序,可在
ext_json中 store_info 传入交易所属门店信息,让评价的内容更有参考价值(如上图)。 - 针对有物流交付的小程序,可在
ext_json中 shipping_list 传入物流消息,让平台邀请用户发表评价的时机更准确。