支付结果通知API(支持单品优惠)

更新时间：2024.11.18

场景介绍

支付接口上传参数version后，则支付通知也将返回单品信息，同时取消以下字段返回（转移到新增参数promotion_detail中，以json方式展示），开发时请注意：

字段名称	字段说明
代金券使用数量（coupon_count）	取消了该参数返回，我们将展示每张券的具体信息，商户可以通过解析promotion_detail参数来确认使用了几张代金券。
总代金券金额（coupon_fee）	取消了该参数返回，返回参数展示了每张券的金额（amount），商户可以通过累加得出总代金券金额。
单个代金券支付金额（coupon_fee_$n）	与amount对应
代金券类型（coupon_type）	与type 对应，COUPON表示普通代金券（原值：CASH），DISCOUNT表示免充值券（原值：NO_CASH）
代金券id（coupon_id）	与 promotion_id 对应
应结订单金额（settlement_total_fee）	取消了该参数返回，商户可以通过现有返回参数计算出应结订单金额，应结订单金额（settlement_total_fee）=订单总金额（total_fee）-优惠类型（type）为免充值券（DISCOUNT）的优惠券金额（amount）

接口地址

该地址是通过【统一下单API】中提交的参数notify_url设置，如果通知url无法访问，商户将无法接收到微信通知，所以通知url必须为直接可访问的url，不能携带参数。示例：notify_url：“https://pay.weixin.qq.com/wxpay/pay.action”

是否需要证书

不需要。

通知参数

名称	变量名	必填	类型	示例值	描述
其他返回字段列表见支付结果通知API（普通商户）支付结果通知API（服务商）
营销详情	promotion_detail	是	String(6000)	示例见下文	新增返回参数，请务必做好通知结果的签名验收工作。统一下单API上传参数version后才有返回，返回值为Json格式

名称

变量名

必填

类型

示例值

描述

其他返回字段列表见

支付结果通知API（普通商户）

支付结果通知API（服务商）

营销详情

promotion_detail

是

String(6000)

示例见下文

新增返回参数，请务必做好通知结果的签名验收工作。统一下单API上传参数version后才有返回，返回值为Json格式

单品优惠活动promotion_detail字段列表说明：

名称

变量名

必填

类型

示例值

描述

券ID

promotion_id

是

String(32)

109519

券或者立减优惠id

优惠名称

name

否

String(64)

单品惠-6

优惠名称

优惠范围

scope

否

String(32)

SINGLE

GLOBAL- 全场代金券

SINGLE- 单品优惠

优惠类型

type

否

String(32)

DISCOUNT

COUPON- 代金券，需要走结算资金的充值型代金券,（境外商户券币种与支付币种一致）

DISCOUNT- 优惠券，不走结算资金的免充值型优惠券，（境外商户券币种与标价币种一致

优惠券面额

amount

是

int

用户享受优惠的金额

活动ID

activity_id

是

String(32)

931386

在微信商户后台配置的批次ID

微信出资

wxpay_contribute

否

int

特指由微信支付商户平台创建的优惠，出资金额等于本项优惠总金额，单位为分

商户出资

merchant_contribute

否

int

特指商户自己创建的优惠，出资金额等于本项优惠总金额，单位为分

其他出资

other_contribute

否

int

其他出资方出资金额，单位为分

商品列表

goods_detail

否

String

见下文

商品信息，使用Json数组格式提交,字段详细说明请点击行前的+展开

商品列表

注意：goods_remark为备注字段，按照配置原样返回，goods_tag是订单优惠标记，用于区分订单是否可以享受优惠，两个字段内容都在微信后台配置券时进行设置。

promotion_detail字段值举例如下：

1{
2    "promotion_detail":[
3        {
4            "promotion_id":"109519",
5            "name":"单品惠-6",
6            "scope":"SINGLE",
7            "type":"DISCOUNT",
8            "amount":5,
9            "activity_id":"931386",
10            "wxpay_contribute":0,
11            "merchant_contribute":0,
12            "other_contribute":5,
13            "goods_detail":[
14                {
15                    "goods_id":"a_goods1",
16                    "goods_remark":"商品备注",
17                    "quantity":7,
18                    "price":1,
19                    "discount_amount":4
20                },
21                {
22                    "goods_id":"a_goods2",
23                    "goods_remark":"商品备注",
24                    "quantity":1,
25                    "price":2,
26                    "discount_amount":1
27                }
28            ]
29        }
30    ]
31}

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服