开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
文档中心
服务商 
如何成为服务商
业务中心
服务商运营
代运营中心
小程序
商家粉丝群
生活号
支付券
商家券
会员卡
五福专区
账户中心
技术合作
常见问题
操作指引 > 代运营中心 > 支付券 >  > 订单优惠标记-使用说明
收藏
我的文档
设置
1 功能简介
“订单优惠标记”(下文简称“标记”)是面向使用支付券的商家,提供的一个可以自定义券核销规则的功能字段。商家使用时需要改造自己的收单交易接口,增加标记参数,只有优惠券配置时填写的“标记”与收单交易入参的“标记”匹配一致时,优惠券才可以核销使用。
2 “订单优惠标记”的设置
在创建支付券时,“核销规则”的“规则类型”分“标准”和“自定义”两种模式。
“标准”即为原支付宝平台统一管理的通用规则,包括“收款账号”、“限制小程序”、“限制门店”。其中“收款账号”包括商家可用权限范围内的直连收单账号(pid)和间连收单账号(smid),“限制小程序”为仅限使用了商家小程序支付能力时可用,“限制门店”为仅限在指定的门店发生交易时可用。当同时配置多个限制条件时,需同时满足所有条件才可以核销支付券。
image.png

“自定义”即为由商家自行管理的核销规则,仅包括“收款账号”和“订单优惠标记”两个限制条件。“收款账号”逻辑同上。“订单优惠标记”为商家自行管理的核销标记,商家需要自定义标记的值和含义,并通过改造收单接口来匹配该标记。
image.png

“订单优惠标记”包含“标记值”和“标记备注”两部分组成。“标记值”是具体用来匹配交易信息的标识,“标记备注”是用来备注标记含义,该备注内容仅为方便商家管理查看,并不会对消费券透出。
“标记值”支持输入字母、数字、下划线,最多支持32个字符,每张券最多支持添加5个优惠标记,当交易参数匹配当中任意一个标记时即可核销使用。
3 收单交易接口的改造
由于“订单优惠标记”是券的“标记”和交易“标记”进行匹配,所以在券上配置了“标记”后,需要在交易接口也增加对应“标记”才可以进行两两匹配。
以统一收单交易创建接口(alipay.trade.create)为例,需要在交易接口的promo_params(营销信息)中增加具体标记值,该参数为json格式,具体增加的json对应key为promo_tag,请求示例如下:
(以java为例,其它语言可查看收单交易接口示例)
promo_params生成的请求json示例:
也就是说,当交易收单接口传入promo_tag的值(示例中的test_abc),与创建支付券页填入的“标记值”完全匹配时,可通过该核销条件判断。(须同时满足“收单账号”及其它限制条件时券可正常核销)
image.png

特别注意,每笔交易中的promo_tag只支持传入1个标记值,如果传入多组promo_tag标记或1个promo_tag中传入多个值,会导致无法正常匹配支付券标记,进而无法核销支付券。
4 常见问题
支付券[标准]核销规则与交易订单校验关系(当支付券配置多种规则时,需所有规则全部匹配才可核销):
image.png

支付券[自定义]核销规则与交易订单校验关系:
image.png

支付券的[订单优惠标记]和支付宝交易参数的匹配关系:
image.png

内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图