# 交易信息回传接口

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

![](https://res.wx.qq.com/op_res/Lv2r3s0ZprtjlyJGVGu6PbYOFVYSLuaCU8am4WicT8iSAPqp0V3CIcfHk3U2pH0xB1CmaBHzLznG6hyOw1HjTA)

"交易评价-交易信息回传" 与 ["订阅消息-新版一次性订阅消息Beta"](/miniprogram/dev/framework/open-ability/subscribe-message-2.md) 接口共用 。可以只接入"交易评价信息回传"(A)，也可以一次接入实现 2 个功能（ B ），详细方法如下：

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

如果暂不接入"新版一次性订阅消息"，仅回传交易信息实现"评价能力升级"，
参照["订阅消息-新版一次性订阅消息Beta"](/miniprogram/dev/framework/open-ability/subscribe-message-2.md) 接入，**需注意以下 2 点：**

### 1. 激活与更新卡片 setUserNotify

在[激活与更新服务卡片](/miniprogram/dev/server/API/mp-message-management/subscribe-message/api_setusernotify.md)时，注意：

1. `content_json` 中 `product_list` 的 `count`、`single_price` 字段需必传
2. `content_json` 中 `cur_status` 状态只需传入到"已支付"这个状态

>"已支付"状态不会触发订阅消息，仅在微信-发现-小程序 tab 有红点提示（如下图）。
>
> ![](https://res.wx.qq.com/op_res/Lv2r3s0ZprtjlyJGVGu6PdnoeCFe44bgn8MmDllFYIV-q2fETR7P40JCa2BZOR3uT4SYJYYF_8E8o69kSq3uSw)

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

### 2. 配置更多服务相关信息setUserNotifyExt

接口[更新服务卡片扩展信息](/miniprogram/dev/server/API/mp-message-management/subscribe-message/api_setusernotifyext.md)，当需要为评价配置更多交易信息时再调用（例如：门店信息、物流信息等）。

调用顺序：先调用上面的主接口[激活与更新服务卡片](/miniprogram/dev/server/API/mp-message-management/subscribe-message/api_setusernotify.md)成功后，再调用扩展接口[更新服务卡片扩展信息](/miniprogram/dev/server/API/mp-message-management/subscribe-message/api_setusernotifyext.md)，并传入扩展接口请求参数 `ext_json`。

`ext_json` 为扩展信息：不同动态卡片定义不同，可在[订阅消息](/miniprogram/dev/framework/open-ability/subscribe-message-2.md)文档中（ 1.1 中各模版定义链接）中查阅，例如：

1. 针对有门店的小程序，可在 `ext_json`中 **store_info** 传入交易所属门店信息，让评价的内容更有参考价值（如下图）。
2. 针对有物流交付的小程序，可在 `ext_json` 中 **shipping_list** 传入物流消息，让平台邀请用户发表评价的时机更准确。

    ![](https://res.wx.qq.com/op_res/Lv2r3s0ZprtjlyJGVGu6PU2UpifMPwb8HRQdEg-dA4AmWaOCaOS2bpT-_8JeBwOicRAL6hq_gmcVq32Y4J2skQ)
    ![](https://res.wx.qq.com/op_res/Lv2r3s0ZprtjlyJGVGu6PWuLDwxaxSaJiS7vd9l5eIZF29i-FFc1TmQoUPns2FB4CaBzv4J1sREmdfJ7OkzSfQ)

## B. "评价能力升级"与"新版一次性订阅消息"功能一起接入

如果 2 个功能都想实现，则按照 [新版一次性订阅消息Beta](/miniprogram/dev/framework/open-ability/subscribe-message-2.md) 步骤接入即可，**需注意以下 2 点：**

### 1.激活与更新卡片 setUserNotify

在[激活与更新服务卡片](/miniprogram/dev/server/API/mp-message-management/subscribe-message/api_setusernotify.md)时，注意：`content_json` 中 `product_list` 的 `count`、`single_price` 字段需必传。

### 2.配置更多服务相关信息setUserNotifyExt

接口[更新服务卡片扩展信息](/miniprogram/dev/server/API/mp-message-management/subscribe-message/api_setusernotifyext.md)，当需要为评价配置更多交易信息时再调用（例如：门店信息、物流信息等）。

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

`ext_json` 为扩展信息：不同动态卡片定义不同，可在[订阅消息](/miniprogram/dev/framework/open-ability/subscribe-message-2.md)文档中（ 1.1 中各模版定义链接）中查阅，例如：

1. 针对有门店的小程序，可在 `ext_json` 中 **store_info** 传入交易所属门店信息，让评价的内容更有参考价值（如上图）。
2. 针对有物流交付的小程序，可在 `ext_json` 中 **shipping_list** 传入物流消息，让平台邀请用户发表评价的时机更准确。