# 交易评价-交易信息回传接口

回传交易信息（商品、服务、门店），可以提升用户消费评价的体验，还可以通过评价直达商品/服务的落地页。

“交易评价-交易信息回传“ 与 “订阅消息-新版一次性订阅消息Beta” 接口共用。可以只接入"交易评价信息回传"(A)，也可以一次接入实现2个功能（B），详细方法如下：

# A.想实现“评价能力升级“，暂不接入“新版一次性订阅消息“

如果暂不接入“新版一次性订阅消息“，仅回传交易信息实现“评价能力升级”，参照“订阅消息-新版一次性订阅消息Beta” 接入，需注意以下2点：

在激活与更新卡片setUserNotify时，注意：

① content_json 中 product_list 的count、single_price 字段需必传

② content_json 中 cur_status 状态只需传入到“已支付”这个状态

“已支付”状态不会触发订阅消息，仅在微信-发现-小程序tab有红点提示（如图1）。

（图1）

完成以上2点，即可回传主要交易信息，实现评价能力升级。

此接口为扩展接口setUserNotifyExt，当需要为评价配置更多交易信息时再调用（例如：门店信息、物流信息等）。

调用顺序：先调用上面的主接口setUserNotify成功后，再调用扩展接口setUserNotifyExt，并传入扩展接口请求参数ext_json。

ext_json为扩展信息：不同动态卡片定义不同，可在“订阅消息”文档中（1.1中各模版定义链接）中查阅，例如：

① 针对有门店的小程序，可在ext_json中store_info传入交易所属门店信息，让评价的内容更有参考价值（如图2）。

② 针对有物流交付的小程序，可在ext_json中shipping_list传入物流消息，让平台邀请用户发表评价的时机更准确。

（图2）

如果2个功能都想实现，则按照 “订阅消息-新版一次性订阅消息Beta” 步骤接入即可，需注意以下2点：

在激活与更新卡片setUserNotify时，注意：content_json中product_list的count、single_price字段需必传。

此接口为扩展接口setUserNotifyExt，当需要为评价配置更多交易信息时再调用（例如：门店信息、物流信息等）。

调用顺序：先调用上面的主接口setUserNotify成功后，再调用扩展接口setUserNotifyExt，并传入扩展接口请求参数ext_json。

ext_json为扩展信息：不同动态卡片定义不同，可在“订阅消息”文档中（1.1中各模版定义链接）中查阅，例如：

① 针对有门店的小程序，可在ext_json中store_info传入交易所属门店信息，让评价的内容更有参考价值（如图2）。

② 针对有物流交付的小程序，可在ext_json中shipping_list传入物流消息，让平台邀请用户发表评价的时机更准确。