微信礼品卡订单查询
顾客在小程序里买了礼品卡、送给了谁、送成功没有、要不要退款,都在这个窗口回查。它每次查询会先向微信把订单拉回来,再按条件列出结果:上方是订单主表,下方跟着显示选中那一单的逐卡明细。确认要退的单子,选中后点工具栏【退款】。
功能路径:系统菜单 → O2O业务 → 微信礼品卡 → 微信礼品卡订单查询
一、功能概述
1. 解决什么问题
- 对账:按时间区间列出礼品卡订单与总金额,和微信商户平台的收款记录核对;
- 追赠送:看购买人 OPENID 与接收 OPENID,判断卡送出去了没有、送给了谁;
- 看明细:一单买了哪几张卡、每张卡多少钱、卡号是什么;
- 退款:对生效订单发起微信退款,退完状态就地改成「退款」。
2. 数据从哪来
点【查询】时软件先调微信接口把订单下载到本地,再按条件查本地表。微信侧下载失败就不会出结果,直接弹「[错误码]错误说明」。所以查不到单先分清是下载失败还是条件太窄。
3. 与相邻窗口的分工
| 窗口 | 管什么 |
|---|---|
| 微信礼品卡 | 卡的定义、价格有效期、自定义券号 |
| 微信礼品卡货架 | 卡怎么摆、上架哪些卡 |
| 微信礼品卡订单查询(本窗口) | 买卡送卡的订单回查与退款 |
二、界面布局说明
窗口顶部工具栏是【退出】【退款】【帮助】三个按钮。左侧「请选择」条件区集中放查询条件与【查询】按钮,右侧上方是订单主表、下方是卡明细表。

顶部工具栏
| 按钮 | 作用 |
|---|---|
| 退出 | 关闭本窗口 |
| 退款 | 对当前选中的订单发起微信退款 |
| 帮助 | 打开本窗口对应的在线帮助 |
查询条件区
| 条件 | 说明 |
|---|---|
| 开始时间 | 业务日期区间起点,打开窗口时默认是 7 天前 |
| 结束时间 | 业务日期区间终点,打开窗口时默认是明天 |
| 订单状态 | 下拉两项:生效 / 退款,打开窗口时默认停在「生效」 |
| 交易流水号 | 按微信支付交易流水号模糊查找,留空则不限 |
【查询】按钮在条件区下方。区间跨度受当前操作员查询方案的最大天数与可查起始日期限制,超限会被拦下,缩小区间再查。
订单主表
| 列名 | 含义 |
|---|---|
| 业务日期 | 这笔订单的业务日期,区间筛选与排序都按它 |
| 订单状态 | 生效 / 退款,见第四节 |
| 交易流水号 | 微信支付侧的交易流水号,退款确认提示里带的就是它 |
| 创建时间 | 订单创建时间 |
| 支付时间 | 支付完成时间 |
| 总金额 | 这一单的总金额 |
| OPENID | 购买人的微信 OPENID |
| 接收OPENID | 接收礼品卡一方的微信 OPENID |
结果按业务日期、创建时间排序。
卡明细表
主表选中一行,下方明细表自动按该单列出逐卡记录:
| 列名 | 含义 |
|---|---|
| 业务日期 | 与主表同一单的业务日期 |
| 卡号 | 这一张礼品卡的卡号 |
| 卡标题 | 卡的名称,取自礼品卡档案 |
| 价格 | 这一张卡的价格 |
| 接收openid | 这一张卡的接收方微信 OPENID |
一单买多张送多人时,逐卡的接收 openid 可能各不相同,按行看。
三、业务操作步骤
步骤 1:设定条件并查询
- 打开窗口,开始时间与结束时间已默认填好近一周多的区间,按对账口径改成实际区间;
- 要定位某一笔就在交易流水号里填流水号片段;
- 点【查询】,软件先向微信下载订单,再列出结果;
- 下载或查询失败时弹「[错误码]错误说明」,按第六节与第七节排查。
步骤 2:看某一单的卡明细
- 在订单主表里点中要看的那一行;
- 下方卡明细表自动刷新,列出这一单的每张卡;
- 核对卡号、卡标题、价格与接收 openid,判断卡是否送到了指定的人。
步骤 3:对生效订单退款
- 在主表选中要退的那一单;
- 点工具栏【退款】,弹出「确定要退款此订单[交易流水号]吗?」,核对流水号无误再确认;
- 软件调微信退款接口,成功后把这一单的状态就地改成「退款」,并弹出接口返回说明;
- 已经是退款状态的单子再点【退款】,提示「已退款订单不能继续退款!」;
- 接口返回失败时弹「[错误码]错误说明」,状态不变,按说明处理后重试。
四、字段详细说明
订单状态的两种显示
状态列只有两种显示:值为退款时显示「退款」,其余一律显示「生效」。所以「生效」是一个兜底显示,不代表微信侧一定已出款成功,判断是否真正完成要看支付时间有没有值。
状态筛选与状态列的口径不一致
当前版本里,订单状态下拉选「生效」时查出来的是区间内的全部订单(含已退款的),选「退款」时查出来的行在状态列仍显示「生效」。要挑退款单,先把区间内订单全查出来,再按订单状态列人工挑显示「退款」的那几行,不要依赖下拉筛选。
两个 OPENID 的区别
| 列 | 是谁 |
|---|---|
| OPENID | 掏钱买卡的人 |
| 接收OPENID | 收到卡的人 |
顾客自己买给自己时两者相同;送人时不同。明细表里的「接收openid」是逐卡的接收方,一单送多人时以明细为准。
三个时间的区别
| 列 | 含义 |
|---|---|
| 业务日期 | 软件侧用于归集与筛选的日期,区间条件按它过滤 |
| 创建时间 | 顾客下单的时间 |
| 支付时间 | 顾客付款完成的时间,为空说明这一单还没付 |
对账按业务日期归集,追顾客什么时候付的钱看支付时间。
五、典型使用场景
场景 1:月底核对礼品卡收款
背景:财务要核当月礼品卡卖了多少钱。 操作:开始时间与结束时间设成当月首尾 → 订单状态留默认 →【查询】→ 按总金额合计与微信商户平台收款记录核对 → 差异单看支付时间是否为空,未付款的不计入收款。
场景 2:顾客说买了卡但朋友没收到
背景:顾客反馈送卡失败。 操作:按顾客提供的交易流水号或购买时间区间查出该单 → 看主表接收OPENID 有没有值 → 再看卡明细逐卡的接收openid → 有值说明已送出,让接收方在微信卡包里找;为空说明赠送未完成,按第七节处理。
场景 3:顾客要求退掉买错的卡
背景:顾客买错档位要求退款。 操作:查出该单并选中 → 点【退款】→ 核对确认提示里的交易流水号 → 确认后状态变「退款」→ 把接口返回说明与退款时间告知顾客,到账以微信侧为准。
六、权限控制与前置条件
- 需具备 O2O业务 → 微信礼品卡 的菜单权限;
- 礼品卡模块要已授权,未授权时点击菜单提示「尚未购买礼品卡模块无法使用!」;
- 公众号与微信支付的服务地址、凭据要先配好,下载订单与退款都走同一个微信服务接口;
- 查询区间跨度受当前操作员查询方案的最大天数与可查起始日期限制;
- 【退款】按钮不做单独的权限判断,能打开本窗口就能退款。退款是资金操作,建议按岗位收紧本窗口的菜单授权,只给需要退款的人。
七、常见问题
1. 点查询弹「[错误码]错误说明」,没有结果
- 原因:向微信下载订单这一步失败,常见于服务地址或凭据不对、微信侧接口异常;
- 处理:先核对微信对接设置里的服务地址与凭据,再重试;仍失败把错误码与查询区间交技术服务。
2. 下载成功但列表是空的
- 原因:业务日期区间太窄,或该区间内确实没有订单;
- 处理:把区间放宽到确定有单的那几天再查;注意区间按业务日期过滤,不是按创建时间。
3. 填了交易流水号就查询报错
- 原因:当前版本按交易流水号拼查询条件时会出错;
- 处理:清空交易流水号,只按时间区间查全量,再在结果的交易流水号列里定位那一笔。
4. 选「退款」筛出来的单子显示「生效」
- 原因:状态筛选与状态列的口径不一致,见第四节;
- 处理:不用下拉筛选,按区间查全量后看订单状态列挑「退款」行。
5. 点退款提示「已退款订单不能继续退款!」
- 原因:这一单已经是退款状态;
- 处理:不重复退。顾客说没收到退款时,拿交易流水号到微信商户平台查退款记录,到账以微信侧为准。
6. 退款成功但顾客说没收到钱
- 原因:微信退款到账有延迟,或原支付账户异常;
- 处理:软件侧状态已改成「退款」即表示微信受理成功,拿交易流水号到微信商户平台核对退款进度。
附:与其他功能的关系
| 环节 | 对应功能 |
|---|---|
| 卡的定义 | 微信礼品卡 |
| 货架与上架 | 微信礼品卡货架 |
| 公众号与微信支付凭据 | 商城管理员与电子券投放 |
| 商城侧的线上订单 | 线上订单 |
