凭证消息通知

用于向商家同步凭证的触发事件，如发放、核销、取消核销、退款等

注意：

商家需要通过监听此消息通知获取凭证在支付宝域内的触发事件，并根据action字段识别通知类型，并进行相应的商家侧业务处理。

公共请求参数

业务消息属性

action**｜凭证的触发事件**必选string(32)

【描述】此参数用来表示凭证的触发事件，用来表示凭证在支付宝域内已完成的业务动作，如用户在支付宝域内购买本地生活商品后会协同商户完成权益凭证发放，并在发放成功后通过此消息通知告诉商家凭证已发放完成。商家需要根据此字段识别凭证被触发的动作

【枚举值】

发放凭证: SEND

核销凭证: USE

取消核销凭证: CANCEL_USE

【示例值】SEND

order_id**｜支付宝订单id**必选string(64)

【描述】购买商家业务主体时的营销订单号，如购买本地生活商品的订单号。

【示例值】2015042321001004720200028594

user_id**｜用户id**必选string(32)

【描述】用户uid 想了解openid？

【示例值】2088xxxx

biz_time**｜业务触发时间**必选string(32)

【描述】业务触发时间，如在发放事件中是完成发放的时间。

【示例值】1683273353000

code**｜商家发放的三方码值**必选string(64)

【描述】服务商发奖后返回的券码列表. 限制：单个code最长64位。商户上传的券code列表，code允许包含的字符有0-9、a-z、A-Z、-、_、+、=、|。如果发生券码后校验不通过.支付宝内部不会进行发奖。针对这种case会通知服务商进行整改，该笔交易支付宝内部不会发奖成功。

【示例值】123aaa

certificate_id**｜三方码关联的支付宝侧id**必选string(32)

【描述】三方码关联的支付宝侧id，支付宝侧的唯一标识。

【示例值】2023050500422001809100003190

item_id**｜支付宝商品id**必选string(32)

【描述】支付宝商品id

【示例值】20230101300000202301234

total_count**｜凭证总共可使用次数**可选string(10)

【描述】凭证总共可使用次数

【示例值】2

used_count**｜凭证已使用次数**可选string(10)

【描述】凭证已使用次数

【示例值】1

usable_count**｜凭证剩余可用次数**可选string(10)

【描述】凭证剩余可用次数

【示例值】1

certificate_serial_no_list**｜本次操作涉及的凭证次序号**可选string

【描述】本次操作涉及的凭证次序号

【示例值】["2023100100445016538200364374"]

响应值

响应值	描述	是否重试
fail	消息获取失败	是
success	消息获取成功	否

凭证消息通知

公共请求参数#

业务消息属性#

响应值#

消息示例#

公共请求参数

业务消息属性

响应值

消息示例