支付增值服务
接口列表
代金券
代金券核销事件回调通知

核销事件回调通知

注意：同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。推荐的做法是，当商户系统收到通知进行处理时，先检查对应业务数据的状态，并判断该通知是否已经处理。如果未处理，则再进行处理；如果已处理，则直接返回结果成功。在对业务数据进行状态检查和处理之前，要采用数据锁进行并发控制，以避免函数重入造成的数据混乱。

通知规则

用户使用券后，微卡会把相关核销券信息发送给商户，商户需要接收处理，并按照文档规范返回应答。出于安全的考虑，我们对核销券信息数据进行了加密，商户需要先对通知数据进行解密，才能得到核销券信息数据。

对后台通知交互时，如果微卡收到应答不是成功或超时，微卡认为通知失败，微卡会通过一定的策略定期重新发起通知，尽可能提高通知的成功率，但微卡不保证通知最终能成功。

接口说明

请求方式：
post
接入方提供的回调地址

请求参数

Request
Body 包体
ocode必填
string

微卡收付通主体

最小长度：1     最大长度：20
channel_merchant_id必填
string

微卡收付通商户号

最小长度：1     最大长度：20
stock_creator_mchid必填
string

批次创建方商户号。
示例值：9800064

最小长度：1     最大长度：20
stock_id必填
string

微卡为每个代金券批次分配的唯一id。
示例值：9865888

最小长度：1     最大长度：20
coupon_id选填
string

微卡为代金券唯一分配的id。
示例值：98674556

最小长度：1     最大长度：20
singleitem_discount_off选填
object

单品优惠特定信息。

discount_to选填
object

减至优惠限定字段，仅减至优惠场景有返回。

coupon_name必填
string

代金券名称
示例值：微卡收付通代金券

最小长度：1     最大长度：20
status必填
string

代金券状态：
SENDED：可用
USED：已实扣
EXPIRED：已过期
示例值：EXPIRED

最小长度：1     最大长度：16
description必填
string

代金券描述说明字段。
示例值：微卡收付通营销

最小长度：1     最大长度：3000
create_time必填
string

领券时间，遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示，北京时间2015年5月20日13点29分35秒。
示例值：2015-05-20T13:29:35+08:00

最小长度：1     最大长度：32
coupon_type必填
string

NORMAL：满减券
CUT_TO：减至券
示例值：CUT_TO

最小长度：1     最大长度：16
no_cash必填
bool

true：是
false：否
示例值：true

available_begin_time必填
string

可用开始时间，遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日13点29分35秒。
示例值：2015-05-20T13:29:35+08:00

最小长度：1     最大长度：32
available_end_time必填
string

可用结束时间，遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日13点29分35秒。
示例值：2015-05-20T13:29:35+08:00

最小长度：1     最大长度：32
singleitem必填
bool

true：是
false：否
示例值：true

normal_coupon_information选填
object

普通满减券面额、门槛信息。

consume_information选填
object

已实扣代金券信息。

请求示例

{
  "stock_creator_mchid": "9800064",
  "stock_id": "9865888",
  "coupon_id": "98674556",
  "channel_merchant_id": "CM465922975711959340",
  "singleitem_discount_off": {
    "single_price_max": 100
  },
  "discount_to": {
    "cut_to_price": 100,
    "max_price": 10
  },
  "coupon_name": "微卡收付通代金券",
  "status": "EXPIRED",
  "description": "微卡收付通营销",
  "create_time": "2015-05-20T13:29:35+08:00",
  "coupon_type": "CUT_TO",
  "no_cash": true,
  "available_begin_time": "2015-05-20T13:29:35+08:00",
  "available_end_time": "2015-05-20T13:29:35+08:00",
  "singleitem": true,
  "normal_coupon_information": {
    "coupon_amount": 100,
    "transaction_minimum": 100
  },
  "consume_information": {
    "consume_time": "2015-05-20T13:29:35+08:00",
    "consume_mchid": "9856081",
    "transaction_id": "4200752501201407033233368018",
    "goods_detail": [
      {
        "goods_id": "a_goods1",
        "quantity": 7,
        "price": 1,
        "discount_amount": 4
      }
    ]
  }
}

通知应答

接收成功：HTTP 应答状态码需返回 200 或 204，无需返回应答报文。

接收失败：HTTP 应答状态码需返回 5XX 或 4XX，同时需返回应答报文，格式如下：

参数名变量类型[长度限制]必填描述
返回状态码codestring[1,32]是错误码，SUCCESS为接收成功，其他错误码为失败。
示例值：FAIL
返回信息messagestring[1,64]是返回信息，如非空，为错误原因。
示例值：失败
腾讯微卡收付通接口文档