---
url: "https://pay.weixin.qq.com/doc/brand/4015562429.md"
title: "下单同步用户实时动态"
doc_id: 4015562429
---

>更新时间：2025.11.04

## 1、能力概述

通过此能力同步微信支付渠道的会员动态信息到微信支付商家名片会员。比如用户的积分变更，用户再消费多少可以用积分兑换什么，可以及时的告知用户。 辅助商家做精细化的会员运营与触达。

该能力将会结合微信支付下单支付凭证cell，支付完成页，将该用户的实时动态信息告知给用户。

如用户通过非微信支付有下单动作，并有相应的会员动态变化，可以通过[创建用户动态信息](https://pay.weixin.qq.com/doc/brand/4015582679.md)这个API接口同步。

## 2、核心产品能力

### 2.1、实时动态的展示

- 会员卡动态是针对积分或者储值（储值仅开放给限定商家）的变更信息，提供给商家告知用户的运营能力。

- 比如用户支付了一笔订单，对应某一张会员卡积分增加400，并可兑换礼品。这类信息可以通过会员卡动态传递给用户。

  - 实时动态可以通过支付凭证透传给用户，并联动在商家名片会员卡卡面展示。
- 针对哪一个用户的哪一笔订单展示，由商家自身决定。

- 展示的内容根据模版，可在已有模版允许的变量范围内，结合业务场景传入。


| 实时动态<br>联动支付订单凭证展示 | 实时动态<br>联动入会有礼活动在支付完成页展示 | 实时动态<br>联动喜欢的商家列表展示 |
| --- | --- | --- |
| ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/a5d17aee29ed8329ac1e4c985a817d50.png) | 当商家按照[2.3实时动态传入的方式](https://pay.weixin.qq.com/doc/brand/4015562429.md#2.3%E3%80%81%E5%AE%9E%E6%97%B6%E5%8A%A8%E6%80%81%E4%BC%A0%E5%85%A5%E7%9A%84%E6%96%B9%E5%BC%8F)，在下单接口内传入了实时动态内容。<br>- 如果传入的实时动态是跟开通用户会员卡有关的模版，平台会校验此时这张会员卡模版是否有生效中的入会有礼活动，如果有的话，则会在展示在用户的支付完成页。（如平台有更高优先级的展示内容时，将不展示）<br>  <br>- 如果商家传入的实时动态是开通用户会员卡相关的模版，但是该张会员卡并没有配置有效的入会有礼活动，也将不展示。<br>  <br>![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/b688cb10c82114b7251b7a63b85de11d.png) | ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/450b0cd60e0f3c7edb148d3796888a96.png) |

### 2.2、实时动态支持的内容

实时动态仅支持针对用户资产变化的内容。对于大多数商家开放的用户资产变更类别为积分和付费会员。

以下内容中，【xxx】为商家自定义内容：子模版，需要提前配置申请，申请通过后，将分配一个子模版ID。【x】和【y】都是变量，无需提前申请，商家下单的时候传入即可。

传入的时候需要将子模版ID，变量等内容传入，详见[2.3实时动态传入的方式](https://pay.weixin.qq.com/doc/brand/4015562429.md#2.3%E3%80%81%E5%AE%9E%E6%97%B6%E5%8A%A8%E6%80%81%E4%BC%A0%E5%85%A5%E7%9A%84%E6%96%B9%E5%BC%8F)。

详细[名片会员-实时动态](https://doc.weixin.qq.com/sheet/e3_ACQA6gYlACoCNGn5YxG5HRNm1guZg?scode=AJEAIQdfAAorRGtujMACQA6gYlACo&tab=BB08J2)

|     |     |     |     |
| --- | --- | --- | --- |
| 类别 | 主场景 | 文案内容 | 模版ID |
| 基础会员开通 | 开通商家会员 | - | 0 |
| 会员积分变动 | 我的商家会员 | 本次积分+【x】 | 1 |
| 会员积分变动 | 我的商家会员 | 收货后积分+【x】 | 2 |
| 会员积分变动 | 我的商家会员 | 本次积分已提交 | 3 |
| 会员积分变动 | 我的商家会员 | 再消费【x】元升【xxx】 | 4 |
| 会员积分变动 | 我的商家会员 | 再消费【x】元保持【xxx】 | 5 |
| 会员积分变动 | 我的商家会员 | 有【x】积分,可兑【y】元券 | 6 |
| 会员积分变动 | 我的商家会员 | 有【x】积分,可抵【y】元 | 7 |
| 会员积分变动 | 我的商家会员 | 积分可兑【x】元券 | 8 |
| 会员积分变动 | 我的商家会员 | 有【x】积分,可兑【xxx】 | 9 |
| 付费权益 | 开通商家付费权益 | 【x】元购【xxx】 | 10 |
| 付费权益 | 开通商家付费权益 | 每月【x】，最高省【y】 | 11 |
| 付费权益 | 开通商家付费权益 | 每年【x】，最高省【y】 | 12 |
| 付费权益 | 开通商家付费权益 | 每月【x】，一单回本 | 13 |
| 付费权益 | 开通商家付费权益 | 【x】元购【y】张【xxx】券 | 14 |
| 付费权益 | 开通商家付费权益 | 【x】折起购【y】元【xxx】 | 15 |
| 付费权益 | 我的商家付费权益 | 【xxx】【x】天后到期 | 16 |
| 付费权益 | 我的商家付费权益 | 还有【x】天到期 | 17 |

### 2.3、实时动态传入的方式

会员内容基于商家原有下单请求中的attach字段，增加cell、card\_id，user\_card\_code。

例如：abcdecell=\[data\]&card\_id=\[data\]&user\_card\_code=\[data\]

其中abcde为商家自身原有attach字段内内容。 微信支付侧按照cell=\[data\]&card\_id=\[data\]&user\_card\_code=\[data\]的格式匹配获取配置的实时动态内容。attach字段维持原有下单接口限制，最多128个字符，请商家合理安排。

- cell

  - 解释：cellmessage的缩写，用于微信识别这串字符，请不要在attach内使用一样的cell, 避免误识别。

  - 必填

  - data内容的格式参考2.3.1填写，不能含有"\["和"\]"字符；

  - 如果attach中含有多个"cell=\[data\]"信息，以匹配到的第一个为准；

  - 模版ID最长5位，子模版ID最长7位，结合变量字段。请商家合理安排。
- card\_id

  - 解释：cardID

  - 必填

  - 会员卡模版id，对应API的card\_id
- user\_card\_code

  - 选填，如果需要导入未开通会员的用户，则需要传入 （可以用此方式实时添加会员，被标识的下单用户，若此前未开通会员卡，将自动生效一张会员卡，详见[3.2、存量会员导入到商家名片的方式](https://pay.weixin.qq.com/doc/brand/4015562403.md#3.2%E3%80%81%E5%AD%98%E9%87%8F%E4%BC%9A%E5%91%98%E5%AF%BC%E5%85%A5%E5%88%B0%E5%95%86%E5%AE%B6%E5%90%8D%E7%89%87%E7%9A%84%E6%96%B9%E5%BC%8F)

  - 会员卡code，对应API的user\_card\_code

#### 2.3.1 cell字段

示例：

商家A-下单接口原有attach字段内容为：“attach=123&is\_newversion=0&trade\_scene=3”

现商家需要针对该笔订单配置“本次积分+400”的支付凭证内容：

1. 商户先确定该模版的ID，假设为1

2. 下单接口attach内容现传入


“attach=123&is\_newversion=0&trade\_scene=3&cell=\[1\_400\]&card\_id=\[111111111\]“

cell中data参数的具体说明：

（1）data参数以下划线"\_"分隔，得到N个参数值。如15\_4.9拆分后得到15和4.9两个参数值

（2）第1个参数值为模板ID，剩余N-1个参数值依次为本模板对应的可替换的参数。

- 假设模板ID为15的内容是"本单立返【x】元现金"，使用15\_4.9作为cell得到的曝光内容为"本单立返4.9元现金"。

- 假设模板ID为15的内容是"有【x】积分兑【xxx】"，使用15\_1200\_1作为cell得到的曝光内容为"有1200积分兑1罐啤酒"。其中“1罐啤酒”为提前说申请的子模版内容，“1”为对应该子模版内容的子模版ID。


## 3、前置准备

1、 下单传入的mchID需要绑定了brandID。

2、 该brandID需要开通商家名片的功能

3、 该brandID需要有至少一张有效的[会员卡模版](https://pay.weixin.qq.com/doc/brand/4015582711.md)。