管理卡券

管理卡券

1474945068813004.jpg

更新日志

版本号更新内容更新时间
V1.0

优化查询code接口,返回信息中增加can_consume字段

,告知开发者该卡券是否可以被核销,同时可以支持返回code状态的查询方式。

2015-8-31
V1.1新增拉取卡券数据接口2015-9-7









查询Code接口

查询code接口可以查询当前code是否可以被核销并检查code状态。当前可以被定位的状态为正常、已核销、转赠中、已删除、已失效和无效code。

接口调用请求说明

HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/code/get?access_token=TOKEN

参数说明

参数是否必须说明
POST数据JSON数据
access_token调用接口凭证






POST数据

{
   "card_id" : "card_id_123+",
   "code" : "123456789",
   "check_consume" : true
}

参数说明

参数名必填类型示例值描述
codestring(20)110201201245单张卡券的唯一标准。
card_idstring(32)

pFS7Fjg8kV1I

dDz01r4SQwMkuCKc

卡券ID代表一类卡券。自定义code卡券必填。
check_consumebooltrue是否校验code核销状态,填入true和false时的code异常状态返回数据不同。











当check_consume为true时返回数据

卡券状态正常:

 {
  "errcode": 0,
  "errmsg": "ok",
  "card": {
    "card_id": "pbLatjk4T4Hx-QFQGL4zGQy27_Qg",
    "begin_time": 1457452800,
    "end_time": 1463155199
  },
  "openid": "obLatjm43RA5C6QfMO5szKYnT3dM",
  "can_consume": true,
  "user_card_status": "NORMAL"
}

卡券状态异常:

{
 "errcode": 40127,
 "errmsg": "invalid user-card status! Hint: the card was given to user, but may be deleted or set unavailable ! hint: [iHBD40040ent3]"
}

当check_consume为false时返回数据

卡券状态正常:

 {
  "errcode": 0,
  "errmsg": "ok",
  "card": {
    "card_id": "pbLatjk4T4Hx-QFQGL4zGQy27_Qg",
    "begin_time": 1457452800,
    "end_time": 1463155199
  },
  "openid": "obLatjm43RA5C6QfMO5szKYnT3dM",
  "can_consume": true,
  "user_card_status": "NORMAL"
}

卡券状态异常:

 {
  "errcode": 0,
  "errmsg": "ok",
  "card": {
    "card_id": "pbLatjnK8NLbWgwMgfMtnj3gaglw",
    "begin_time": 1457625600,
    "end_time": 1460217599
  },
  "openid": "obLatjm43RA5C6QfMO5szKYnT3dM",
  "can_consume": false,
  "user_card_status": "GIFTING"
}
参数名描述
errcode错误码
errmsg错误信息
openid用户openid
card_id卡券ID
begin_time起始使用时间
end_time结束时间
user_card_status

当前code对应卡券的状态

NORMAL          正常 

CONSUMED     已核销 

EXPIRE              已过期 

GIFTING            转赠中

GIFT_TIMEOUT  转赠超时 

DELETE              已删除

UNAVAILABLE   已失效 

code未被添加或被转赠领取的情况则统一报错:invalid serial code

can_consume是否可以核销,true为可以核销,false为不可核销






















注意事项:

1.固定时长有效期会根据用户实际领取时间转换,如用户2013年10月1日领取,固定时长有效期为90天,即有效时间为2013年10月1日-12月29日有效。

2.无论check_consume填写的是true还是false,当code未被添加或者code被转赠领取是统一报错:invalid serial code

获取用户已领取卡券接口

用于获取用户卡包里的,属于该appid下所有可用卡券,包括正常状态和未生效状态

接口调用请求说明

HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/user/getcardlist?access_token=TOKEN

参数说明

参数是否必须说明
POST数据JSON数据
access_token调用接口凭证






POST数据

{
  "openid": "12312313",
  "card_id": "xxxxxxxxxx"
}

  参数说明

参数名必填类型示例值描述
openidstring(64)1231231需要查询的用户openid
card_idstring(32)pFS7Fjg8kV1IdDz01xxxxx卡券ID。不填写时默认查询当前appid下的卡券。







返回数据

 {
"errcode":0,
"errmsg":"ok",
"card_list": [
      {"code": "xxx1434079154", "card_id": "xxxxxxxxxx"},
      {"code": "xxx1434079155", "card_id": "xxxxxxxxxx"}
      ],
       "has_share_card": true
}

  参数说明

参数名描述
errcode错误码
errmsg错误信息
card_list卡券列表
has_share_card是否有可用的朋友的券








查看卡券详情

开发者可以调用该接口查询某个card_id的创建信息、审核状态以及库存数量。

接口调用请求说明

HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/get?access_token=TOKEN

参数说明

参数是否必须说明
POST数据JSON数据
access_token调用接口凭证






POST数据

{
  "card_id":"pFS7Fjg8kV1IdDz01r4SQwMkuCKc"
}
参数名必填类型示例值描述
card_idstring(32)pFS7Fjg8kV1IdDz01r4SQwMkuCKc卡券ID。





返回数据

{
  "errcode": 0,
  "errmsg": "ok",
  "card": {
    "card_type": "DISCOUNT",
    "discount": {
      "base_info": {
        "id": "pbLatjnP97_F9PudzBARQhn7xR7A",
        "logo_url": "http://mmbiz.qpic.cn/mmbiz/p98FjXy8LafmY25YclQ7vw5noBxeVH3DG5AKFR1ZsRgMgsvjll7EkUsZib00J964AEpTjkNXF2HorJHt5mtt45Q/0?wx_fmt=png",
        "code_type": "CODE_TYPE_NONE",
        "brand_name": "微信餐厅",
        "title": "9折优惠券",
        "date_info": {
          "type": "DATE_TYPE_FIX_TERM",
          "fixed_term": 30,
          "fixed_begin_term": 0
        },
        "color": "#10AD61",
        "notice": "到店使用",
        "description": "",
        "location_id_list": [
          218384742,
          402521653,
          402521608
        ],
        "get_limit": 3,
        "can_share": true,
        "can_give_friend": true,
        "status": "CARD_STATUS_VERIFY_OK",
        "sku": {
          "quantity": 100096,
          "total_quantity": 100100
        },
        "create_time": 1457525546,
        "update_time": 1457526240,
        "area_code_list": []
      },
      "discount": 10,
      "advanced_info": {
        "time_limit": [
          {
            "type": "MONDAY"
          },
          {
            "type": "TUESDAY"
          }
        ],
        "text_image_list": [],
        "business_service": [],
        "consume_share_card_list": [],
        "abstract": {
          "abstract": "点击了解更多",
          "icon_url_list": [
            "http://mmbiz.qpic.cn/mmbiz/p98FjXy8LafiawSeJeqBzk8qC40iaKIwUPm4TSCelulzEbAywKr7tWjkd5vRjbmFloUFeThfwhwMUZIXmsCtJpyQ/0?wx_fmt=jpeg"
          ]
        },
        "share_friends": false
      }
    }
  }
}
参数名描述
card_type卡券类型。

团购券:GROUPON; 折扣券:DISCOUNT; 礼品券:GIFT; 

代金券:CASH; 通用券:GENERAL_COUPON; 

会员卡:MEMBER_CARD; 景点门票:SCENIC_TICKET

电影票:MOVIE_TICKET; 飞机票:BOARDING_PASS; 

会议门票:MEETING_TICKET; 汽车票:BUS_TICKET;

base_info基本的卡券数据,见下表,所有卡券通用。
deal_detail团购券专用字段,团购详情。
gift礼品券专用,表示礼品名字。
least_costleast_cost字段为代金券专用,表示起用金额(单位为分)。
reduce_cost代金券专用,表示减免金额(单位为分)
discount折扣券专用字段,表示打折额度(百分比),例:填30为七折团购详情。
supply_balance会员卡专属字段,表示是否支持积分,填写true或false,如填写true,积分相关字段均为必填,会员卡专用。
supply_bonus会员卡专属字段,表示否支持储值,填写true或false,如填写true,储值相关字段均为必填,会员卡专用。
bonus_cleared积分清零规则,会员卡专用。
bonus_rules积分规则,会员卡专用。
balance_rules储值规则,会员卡专用。
prerogative会员卡专属字段,表示特权说明,会员卡专用。
bind_old_card_url绑定旧卡的url,会员卡专用。
activate_url激活会员卡,会员卡专用。
need_push_on_view进入会员卡时是否推送事件,填写true或false,会员卡专用。
from飞机票的起点,上限为18个汉字,机票专用。
to飞机票的终点,上限为18个汉字,机票专用。
flight航班,机票专用。
departure_time起飞时间,机票专用。(Unix时间戳格式)
landing_time降落时间,机票专用。(Unix时间戳格式)
check_in_url在线值机的链接,机票专用。
gate登机口。如发生登机口变更,建议商家实时调用该接口变更,机票专用。
boarding_time登机时间,只显示“时分”不显示日期,机票专用。(Unix时间戳格式)
meeting_detail会议详情,会议门票专用。
map_url会场导览图,会议门票专用。









































base_info字段:

参数名描述
logo_url卡券的商户logo,建议像素为300*300。
code_type

"CODE_TYPE_TEXT",文本

"CODE_TYPE_BARCODE",一维码 ;

"CODE_TYPE_QRCODE",二维码;

"CODE_TYPE_ONLY_QRCODE",二维码无code显示;

"CODE_TYPE_ONLY_BARCODE",一维码无code显示;

brand_name

商户名字(填写直接提供服务的商户名

,第三方商户名填写在source字段)。

title卡券名。
color卡券的背景颜色。
notice使用提醒,字数上限为16个汉字。
description使用说明。长文本描述。
date_info使用日期,有效期的信息。
type

使用时间的类型

DATE_TYPE_FIX_TIME_RANGE 表示固定日期区间,DATE_TYPE_FIX_TERM表示固定时长(自领取后按天算),DATE_TYPE_PERMANENT 表示永久有效(会员卡类型专用)。

begin_timestamp

type为DATE_TYPE_FIX_TIME_RANGE时专用

,表示起用时间。从1970年1月1日00:00:00至起用时间的秒数,最终需转换为字符串形态传入,下同。(单位为秒)

end_timestamp

type为DATE_TYPE_FIX_TIME_RANGE时专用

,表示结束时间。(单位为秒)

fixed_term

type为DATE_TYPE_FIX_TERM时专用

,表示自领取后多少天内有效,领取后当天有效填写0。

(单位为天)

fixed_begin_term

type为DATE_TYPE_FIX_TERM时专用

,表示自领取后多少天开始生效。(单位为天)

sku商品信息
quantity卡券现有库存的数量
total_quantity卡券全部库存的数量,上限为100000000。
location_id_list门店位置ID。
use_all_locations
支持全部门店,填写true或false,与location_id_list互斥
use_custom_code是否自定义Code码。填写true或false,默认为false。
bind_openid是否指定用户领取,填写true或false。默认为否。
can_share

卡券是否可转赠,填写true或false,true代表可转赠

默认为true。

service_phone客服电话。
source第三方来源名,例如同程旅游、大众点评。
custom_url_name商户自定义入口名称。
custom_url商户自定义入口跳转外链的地址链接,跳转页面内容需与自定义cell名称保持匹配。
custom_url_sub_title显示在入口右侧的tips,长度限制在6个汉字内。
promotion_url_name营销场景的自定义入口。
promotion_url入口跳转外链的地址链接。
promotion_url_sub_title显示在营销入口右侧的提示语。
custom_url_name商户自定义入口名称。
status

“CARD_STATUS_NOT_VERIFY”,待审核

“CARD_STATUS_VERIFY_FAIL”,审核失败;

“CARD_STATUS_VERIFY_OK”,通过审核;

“CARD_STATUS_DELETE”,卡券被商户删除;

“CARD_STATUS_DISPATCH”,在公众平台投放过的卡券;


























































开发者注意事项

1.对于部分有特殊权限的商家,查询卡券详情得到的返回可能含特殊接口的字段。

2.由于卡券字段会持续更新,实际返回字段包含但不限于文档中的字段,建议开发者开发时对于不理解的字段不做处理,以免出错。


批量查询卡券列表

接口调用请求说明

HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/batchget?access_token=TOKEN

参数说明

参数是否必须说明
POST数据Json数据
access_token调用接口凭证






POST数据

{
  "offset": 0,
  "count": 10, 
  "status_list": ["CARD_STATUS_VERIFY_OK", "CARD_STATUS_DISPATCH"]
}
参数名必填类型示例值描述
offsetint0查询卡列表的起始偏移量,从0开始,即offset: 5是指从从列表里的第六个开始读取。
countint10需要查询的卡片的数量(数量最大50)。
status_liststring(32)

CARD_STATU

S_VERIFY_OK

支持开发者拉出指定状态的卡券列表

“CARD_STATUS_NOT_VERIFY”,

待审核

“CARD_STATUS_VERIFY_FAIL”,

审核失败;

“CARD_STATUS_VERIFY_OK”,

通过审核;

“CARD_STATUS_DELETE”,

卡券被商户删除;

“CARD_STATUS_DISPATCH”,

在公众平台投放过的卡券;



















返回数据

{
  "errcode":0,
  "errmsg":"ok",
  "card_id_list":["ph_gmt7cUVrlRk8swPwx7aDyF-pg"],
  "total_num":1
}
参数名描述
errcode错误码,0为正常。
errmsg错误信息。
card_id_list卡券ID列表。
total_num该商户名下卡券ID总数。








注意事项:

1.未传入筛选条件时,该接口默认传回该商户名下所有状态的卡券;

2.开发者可以请求之后调用查看卡券详情接口确定卡券状态;

更改卡券信息接口

接口说明

支持更新所有卡券类型的部分通用字段及特殊卡券(会员卡、飞机票、电影票、会议门票)中特定字段的信息。

接口调用请求说明

HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/update?access_token=TOKEN

参数说明

参数是否必须说明
POST数据Json数据
access_token调用接口凭证






POST数据

{
       "card_id":"ph_gmt7cUVrlRk8swPwx7aDyF-pg",
       "member_card": {        //填写该cardid相应的卡券类型(小写)。
               "base_info": {
                   "logo_url": "http:\/\/www.supadmin.cn\/uploads\/allimg\/120216\/1_120216214725_1.jpg",
                   "color": "Color010",
                   "notice": "使用时向服务员出示此券",
                   "service_phone": "020-88888888",
                   "description": "不可与其他优惠同享\n如需团购券发票,请在消费时向商户提出\n店内均可使用,
                   仅限堂食\n餐前不可打包,餐后未吃完,可打包\n本团购券不限人数,建议2人使用,
                   超过建议人数须另收酱料费5元/位\n本单谢绝自带酒水饮料"
                   "location_id_list" : [123, 12321, 345345]
               },
                  "bonus_cleared": "aaaaaaaaaaaaaa",
                  "bonus_rules": "aaaaaaaaaaaaaa",
                  "prerogative": ""
       }
}

通用字段修改:

参数名是否提审类型示例值描述
base_info-JSON接口见上述示例卡券基础信息字段。
logo_urlstring(128)mmbiz.qpic.cn/卡券的商户logo,建议像素为300*300。
noticestring(48)请出示二维码核销卡券。使用提醒,字数上限为16个汉字。
descriptionstring(3072)不可与其他优惠同享使用说明。
service_phonestring(24)40012234客服电话。
colorstring(3072)Color010卡券颜色。
location_id_liststring(3072)1234,2314支持更新适用门店列表。
center_titlestring(18)快速使用顶部居中的自定义cell。
center_sub_titlestring(24)点击快速核销卡券顶部居中的自定义cell说明。
center_urlstring(128)www.xxx.com顶部居中的自定义cell的跳转链接。
location_id_liststring(3072)1234,2314

支持更新适用门店列表

,清空门店更新时传“0”

custom_url_namestring(16)立即使用自定义跳转入口的名字。
custom_urlstring(128)"xxxx.com"。自定义跳转的URL。
custom_url_sub_titlestring(18)更多惊喜显示在入口右侧的提示语。
promotion_url_namestring(16)产品介绍。营销场景的自定义入口名称。
promotion_urlstring(128)XXXX.com;入口跳转外链的地址链接。

promotion_url

_sub_title

string(18)卖场大优惠。显示在营销入口右侧的提示语。
code_typestring(16)

CODE_TYPE

_TEXT

Code码展示类型,

"CODE_TYPE_TEXT"

文本;

"CODE_TYPE_BARCODE",

一维码 ;"CODE_TYPE_QRCODE",

二位码;"CODE_TYPE_ONLY_

QRCODE",二维码无code显示;

"CODE_TYPE_ONLY_BARCODE",一维码无code显示;

get_limitint1每人可领券的数量限制。
can_shareboolfalse卡券原生领取页面是否可分享。
can_give_friendboolfalse卡券是否可转赠。
date_infoJson结构见上述示例使用日期,有效期的信息,有效期时间修改仅支持有效区间的扩大。
typestring

DATE_TYPE_FI

X_TIME_RANGE

有效期类型,仅支持更改type为DATE_TYPE_FIX_TIME_RANGE 的时间戳,不支持填入DATE_TYPE_FIX_TERM。
begin_timestampunsigned int14300000固定日期区间专用,表示起用时间。(单位为秒)
end_timestampunsigned int15300000固定日期区间专用,表示结束时间。结束时间仅支持往后延长。






















































不同类型卡券专属字段修改:

特别注意,以下支持更新的字段不在基本信息base_info的结构中。

参数名是否提审类型示例值描述
bonus_clearedstring(3072)每年12月30号积分清0。积分清零规则,会员卡专用。
bonus_rulesstring(3072)每消费1元增加1积分。积分规则,会员卡专用。
balance_rulesstring(3072)支持在线充入余额。储值说明,会员卡专用。
prerogativestring(3072)XX会员可享有全场商品8折优惠。特权说明,会员卡专用。
custom_field1JSON结构创建会员卡示例自定义会员信息类目,会员卡激活后显示,会员卡专用。
custom_field2JSON结构创建会员卡示例自定义会员信息类目,会员卡激活后显示,会员卡专用。
custom_field3JSON结构创建会员卡示例自定义会员信息类目,会员卡激活后显示,会员卡专用。
name_typestring(24)

FIELD_NAME

_TYPE_LEVEL

会员信息类目名称。FIELD_NAME_TYPE_LEVEL等级;FIELD_NAME_TYPE_COUPON优惠券;FIELD_NAME_TYPE_STAMP印花;FIELD_NAME_TYPE_DISCOUNT折扣;FIELD_NAME_TYPE_ACHIEVEMEN成就;FIELD_NAME_TYPE_MILEAGE里程。
urlstring(128)xxx.com点击类目跳转外链url
custom_cell1JSON结构见上述示例。自定义会员信息类目,会员卡激活后显示。
detailstring(3072)电影名:复仇者联盟2。/n放映时间:2015年5月12日23:00。/n票类型:3D。电影票详情。
departure_timeunsigned int1431271351起飞时间。
landing_timeunsigned int1441271351降落时间。
gatestring(12)3号登机口。如发生登机口变更,建议商家实时调用该接口变更。
boarding_timeunsigned int1431271351登机时间,只显示“时分”不显示日期,按Unix时间戳格式填写。如发生登机时间变更,建议商家实时调用该接口变更。
guide_urlstring(128)www.qq.com景区门票的导览图URL。
map_urlstring(128)xxx.com。会场导览图。














































返回数据说明

{
   "errcode":0,
   "errmsg":"ok",
   "send_check":false
}
参数名描述
errcode错误码,0为正常。
errmsg错误信息。
send_check是否提交审核,false为修改后不会重新提审,true为修改字段后重新提审,该卡券的状态变为审核中。








开发者注意事项注

1. 请开发者注意需要重新提审的字段,开发者调用更新接口时,若传入了提审字段则卡券需要重新进入审核状态;

2. 接口更新方式为覆盖更新:即开发者只需传入需要更改的字段,其他字段无需填入,否则可能导致卡券重新提审

3. 若开发者置空某些字段,可直接在更新时传“”(空);

4. 调用该接口后更改卡券信息后,请务必调用查看卡券详情接口验证是否已成功更改,

5.未列出的字段不支持修改更新。

修改库存接口

调用修改库存接口增减某张卡券的库存。

接口调用请求说明

HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/modifystock?access_token=TOKEN

参数说明

参数是否必须说明
POST数据Json数据
access_token调用接口凭证






POST数据

{
"card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc",
"increase_stock_value": 1231231,
"reduce_stock_value": 1231231
}
参数名必填类型示例值描述
card_idstring(32)pFS7Fjg8kV1IdDz01r4SQwMkuCKc卡券ID。
increase_stock_valueint1231231增加多少库存,支持不填或填0。
reduce_stock_valueint1231231减少多少库存,可以不填或填0。









返回数据

 {
"errcode":0,
"errmsg":"ok"
}
参数名描述
errcode错误码
errmsg错误信息






更改Code接口


为确保转赠后的安全性,微信允许自定义Code的商户对已下发的code进行更改。 注:为避免用户疑惑,建议仅在发生转赠行为后(发生转赠后,微信会通过事件推送的方式告知商户被转赠的卡券Code)对用户的Code进行更改。

接口调用请求说明

HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/code/update?access_token=TOKEN

参数说明

参数是否必须说明
POST数据Json数据
access_token调用接口凭证






POST数据

{
  "code": "12345678",
  "card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc",
  "new_code": "3495739475"
}
参数名必填类型示例值描述
card_idstring(32)pFS7Fjg8kV1IdDz01r4SQwMkuCKc卡券ID。自定义Code码卡券为必填。
codestring(16)110201201245需变更的Code码。
new_codestring(64)1231231变更后的有效Code码。








返回数据

 {
"errcode":0,
"errmsg":"ok",
}
参数名描述
errcode错误码
errmsg错误信息






删除卡券接口

删除卡券接口允许商户删除任意一类卡券。删除卡券后,该卡券对应已生成的领取用二维码、添加到卡包JS API均会失效。 注意:如用户在商家删除卡券前已领取一张或多张该卡券依旧有效。即删除卡券不能删除已被用户领取,保存在微信客户端中的卡券。

接口调用请求说明

HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/delete?access_token=TOKEN

参数说明

参数是否必须说明
POST数据Json数据
access_token调用接口凭证






POST数据

{
   "card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc"
}
参数名必填类型示例值描述
card_idstring(32)pFS7Fjg8kV1IdDz01r4SQwMkuCKc卡券ID。




返回数据

 {
"errcode":0,
"errmsg":"ok"
}
参数名描述
errcode错误码
errmsg错误信息






设置卡券失效接口


为满足改票、退款等异常情况,可调用卡券失效接口将用户的卡券设置为失效状态。 

接口调用请求说明

HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/code/unavailable?access_token=TOKEN

参数说明

参数是否必须说明
POST数据Json数据
access_token调用接口凭证






POST数据

非自定义卡券的请求
{
  "code": "12312313"
}
或自定义code卡券的请求。
{
  "code": "12312313",
  "card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc"
}
参数名必填类型示例值描述
card_idstring(32)pFS7Fjg8kV1IdDz01r4SQwMkuCKc卡券ID。
codestring(20)1231231设置失效的Code码。






返回数据

 {
"errcode":0,
"errmsg":"ok",
}
参数名描述
errcode错误码
errmsg错误信息





注意事项:

1.设置卡券失效的操作不可逆,即无法将设置为失效的卡券调回有效状态,商家须慎重调用该接口。

2.商户调用失效接口前须与顾客事先告知并取得同意,否则因此带来的顾客投诉,微信将会按照《微信运营处罚规则》进行处罚。

统计卡券数据

为支持开发者调用API查看卡券相关数据,微信卡券团队封装数据接口并面向具备卡券功能权限的开发者开放使用。

开发者调用该接口可获取本商户下的所有卡券相关的总数据以及指定卡券的相关数据。

拉取卡券概况数据接口

接口说明

支持调用该接口拉取本商户的总体数据情况,包括时间区间内的各指标总量。

接口调用请求说明

HTTP请求方式: POST
URL:https://api.weixin.qq.com/datacube/getcardbizuininfo?access_token=ACCESS_TOKEN

请求参数说明

参数是否必须说明
access_token调用接口凭证
POST数据Json数据






POST数据

{
 "begin_date":"2015-06-15",  //请开发者按示例格式填写日期,否则会报错date format error
 "end_date":"2015-06-30",
 "cond_source":  0
}


参数说明:

字段说明是否必填类型示例值
begin_date查询数据的起始时间。string(16)2015-06-15
end_date查询数据的截至时间。string(16)2015-06-30
cond_source

卡券来源,0为公众平台创建的卡券数据

、1是API创建的卡券数据

unsigned int0








返回数据说明:

{
    "list": [
       {
           "ref_date": "2015-06-23",
           "view_cnt": 1,
           "view_user": 1,
           "receive_cnt": 1,
           "receive_user": 1,
           "verify_cnt": 0,
           "verify_user": 0,
           "given_cnt": 0,
           "given_user": 0,
           "expire_cnt": 0,
           "expire_user": 0
       }
   ] 
}

字段说明:

字段说明
ref_date日期信息
view_cnt浏览次数
view_user浏览人数
receive_cnt领取次数
receive_user领取人数
verify_cnt使用次数
verify_user使用人数
given_cnt转赠次数
given_user转赠人数
expire_cnt过期次数
expire_user过期人数

















特别注意: 

1. 查询时间区间需<=62天,否则报错{errcode: 61501,errmsg: "date range error"}

2. 传入时间格式需严格参照示例填写”2015-06-15”,否则报错{errcode":61500,"errmsg":"date format error"}

3. 该接口只能拉取非当天的数据,不能拉取当天的卡券数据,否则报错。

获取免费券数据接口

接口说明

支持开发者调用该接口拉取免费券(优惠券、团购券、折扣券、礼品券)在固定时间区间内的相关数据。

接口调用请求说明

http请求方式: POSThttps://api.weixin.qq.com/datacube/getcardcardinfo?access_token=ACCESS_TOKEN

请求参数说明

参数是否必须说明
access_token调用接口凭证
POST数据Json数据






POST数据

{
 "begin_date":"2015-06-15",
 "end_date":"2015-06-30",
 "cond_source": 0,
 "card_id": "po8pktyDLmakNY2fn2VyhkiEPqGE"
}

参数说明:

字段说明是否必填类型示例值
begin_date查询数据的起始时间。string(16)2015-06-15
end_date查询数据的截至时间。string(16)2015-06-30
cond_source卡券来源,0为公众平台创建的卡券数据、1是API创建的卡券数据unsigned int0
card_id卡券ID。填写后,指定拉出该卡券的相关数据。string(32)po8pktyDLmakNY2fn2VyhkiEPqGE













返回数据说明 :

{
    "list": [
       {
           "ref_date": "2015-06-23",
           "card_id": "po8pktyDLmakNY2fn2VyhkiEPqGE",
           "card_type":3,
           "view_cnt": 1,
           "view_user": 1,
           "receive_cnt": 1,
           "receive_user": 1,
           "verify_cnt": 0,
           "verify_user": 0,
           "given_cnt": 0,
           "given_user": 0,
           "expire_cnt": 0,
           "expire_user": 0
       }
   ]
}


字段说明:

字段说明
ref_date日期信息
card_id卡券ID
card_typecardtype:0:折扣券,
1:代金券,2:礼品券,3:优惠券,4:团购券(暂不支持拉取特殊票券类型数据,电影票、飞机票、会议门票、景区门票)
view_cnt浏览次数
view_user浏览人数
receive_cnt领取次数
receive_user领取人数
verify_cnt使用次数
verify_user使用人数
given_cnt转赠次数
given_user转赠人数
expire_cnt过期次数
expire_user过期人数





















特别注意:

1. 该接口目前仅支持拉取免费券(优惠券、团购券、折扣券、礼品券)的卡券相关数据,暂不支持特殊票券(电影票、会议门票、景区门票、飞机票)数据。

2. 查询时间区间需<=62天,否则报错{"errcode:" 61501,errmsg: "date range error"};

3. 传入时间格式需严格参照示例填写如”2015-06-15”,否则报错{"errcode":"date format error"}

4. 该接口只能拉取非当天的数据,不能拉取当天的卡券数据,否则报错。

拉取会员卡概况数据接口

接口说明

支持开发者调用该接口拉取公众平台创建的会员卡相关数据。


接口调用请求说明

HTTP请求方式: POST
URL:https://api.weixin.qq.com/datacube/getcardmembercardinfo?access_token=ACCESS_TOKEN

参数说明

参数是否必须说明
POST数据Json数据
access_token调用接口凭证






POST数据

{
 "begin_date":"2015-06-15",
 "end_date":"2015-06-30",
 "cond_source": 0
}

参数说明:

字段说明是否必填类型示例值
begin_date查询数据的起始时间。string(16)2015-06-15
end_date查询数据的截至时间。string(16)2015-06-30
cond_source卡券来源,0为公众平台创建的卡券数据、1是API创建的卡券数据unsigned int0

返回数据说明 :

{
   "list": [
       {
           "ref_date": "2015-06-23",
           "view_cnt": 0,
              "view_user": 0,
              "receive_cnt": 0,
              "receive_user": 0,
              "active_user": 0,
              "verify_cnt": 0,
              "verify_user": 0,
              "total_user": 86,
              "total_receive_user": 95
   ]
}

字段说明:

字段说明
ref_date日期信息
view_cnt浏览次数
view_user浏览人数
receive_cnt领取次数
receive_user领取人数
verify_cnt使用次数
verify_user使用人数
active_user激活人数
total_user有效会员总人数
total_receive_user历史领取会员卡总人数















拉取单张会员卡数据接口

接口说明

支持开发者调用该接口拉取API创建的会员卡数据情况


接口调用请求说明

HTTP请求方式: POST
URL:https://api.weixin.qq.com/datacube/getcardmembercarddetail?access_token=ACCESS_TOKEN

参数说明

参数是否必须说明
POST数据Json数据
access_token调用接口凭证






POST数据

{
 "begin_date":"2015-06-15",
 "end_date":"2015-06-30",
 "card_id":"xxxxxxxxxxxxxxxx"
}

参数说明:


字段说明是否必填类型示例值
begin_date查询数据的起始时间。string(16)2015-06-15
end_date查询数据的截至时间。string(16)2015-06-30
card_id卡券idstring(32)
p4WkzwieuDBzzn7Jed6SBO0-ZgaU

返回数据说明 :

{
  "list": [
    {
      "ref_date": "2016-07-06",
      "merchanttype": 2,
      "cardid": "p4WkzwieuDBzzn7Jed6SBO0-ZgaU",
      "submerchantid": 0,
      "view_cnt": 2,
      "view_user": 1,
      "receive_cnt": 1,
      "receive_user": 1,
      "verify_cnt": 0,
      "verify_user": 0,
      "active_cnt": 1,
      "active_user": 1,
      "total_user": 249,
      "new_user": 0,
      "payOriginalFee": 0,
      "fee": 0
    }
  ]
}

字段说明:

字段说明
ref_date日期信息
merchanttype子商户类型
submerchantid子商户ID
view_cnt浏览次数
view_user浏览人数
receive_cnt领取次数
receive_user领取人数
verify_cnt使用次数
verify_user使用人数
active_user激活人数
total_user有效会员总人数
total_receive_user历史领取会员卡总人数
new_user新用户数
payOriginalFee应收金额(仅限使用快速买单的会员卡)
fee实收金额(仅限使用快速买单的会员卡)