文档中心 > API类目 > 阿里体育场馆服务API

qimen.alibaba.alisports.stadiums.discount.send (权益中心发券)

权益中心发券通知saas 发券

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	描述
template_id	String	必须	1	模板ID
out_coupon_id	String	必须	123	外部优惠券ID 用于处理幂等，确保唯一
receive_channel	String	必须	MERCHANT_BENEFIT	权益中心调用固定传递 "MERCHANT_BENEFIT"
aliuid	String	必须	AIDNAQ	ali userId

响应参数

名称	类型	示例值	描述
msg_code	String	demo	错误码
msg_info	String	demo	错误信息
model	ParkCoupon		出参
└ centerId Number 5 中心id └ orderId String demo 订单id └ receiveChannel String MERCHANT_BENEFIT 领取渠道 MERCHANT_BENEFIT:权益中心 └ thresholdValue String demo 门槛值，单位分 └ outCouponId String biedb_t005 渠道优惠券id └ templateId String park_2021041911351587517749730 模板id └ couponId String park_2021042215421266963651064 Saas中的优惠券id └ userName String demo 用户姓名 └ userId String 2021012915572980795634579 用户id └ consumeStatus String UNCONSUMED 核销状态 UNCONSUMED:未核销 CONSUMED:已核销 INVALID:已失效 └ activateUserId String demo 在承接不同业务的我方理解的激活id(业务的体现是激活手机号) └ operator String demo 操作人员 └ outTemplateId String 590844190252687360 渠道过来的模板id └ discountTemplateType String PARK_COUPON 线上券类型 PARK_COUPON:停车券 └ companyId Number 10000577380 运营商id └ useChannel String demo 核销渠道 MERCHANT_BENEFIT:权益中心 └ name String biedb-t003 模板名 └ discountType String PARK_AMOUNT 优惠方式 PARK_AMOUNT:金额 └ stadiumId Number 3 场馆id └ discountValue String demo 优惠金额或者优惠比例（万分位，8000/10000=80%）或者是小时数
is_success	Boolean	true	是否成功

请求示例

{"out_coupon_id":"123","template_id":"1","aliuid":"AIDNAQ","receive_channel":"MERCHANT_BENEFIT"}

响应示例

{
    "msg_code":"demo",
    "msg_info":"demo",
    "model":{
        "centerId":5,
        "orderId":"demo",
        "receiveChannel":"MERCHANT_BENEFIT",
        "thresholdValue":"demo",
        "outCouponId":"biedb_t005",
        "templateId":"park_2021041911351587517749730",
        "couponId":"park_2021042215421266963651064",
        "userName":"demo",
        "userId":"2021012915572980795634579",
        "consumeStatus":"UNCONSUMED",
        "activateUserId":"demo",
        "operator":"demo",
        "outTemplateId":"590844190252687360",
        "discountTemplateType":"PARK_COUPON",
        "companyId":10000577380,
        "useChannel":"demo",
        "name":"biedb-t003",
        "discountType":"PARK_AMOUNT",
        "stadiumId":3,
        "discountValue":"demo"
    },
    "is_success":true
}

验签示例

{"msg_code":"sign-check-failure","msg_info":"Illegal request","is_success":"false"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

阿里体育场馆服务API

qimen.alibaba.alisports.stadiums.discount.send (权益中心发券)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ