开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
文档中心
网页&移动应用 
支付产品
私域产品
公域产品
营销产品
资金产品
会员产品
信用产品
安全产品
广告产品
其他通用产品
小程序交易投诉处理
收单资金结算到银行账户的到账消息
蚂蚁门店管理
ccm 插件化能力
学校库
分享到支付宝
商家账单数据查询及下载接口
商户自主监控
网站支付宝登录
支付宝卡包
电子发票
生活缴费
中小学教育缴费
地铁线上购票
车主平台停车在线缴费
口碑开店
私域营销
接入指南
api 列表
活动查询
券活动查询
用户券查询
券状态消息
可用范围查询
订单可用券查询
活动发放
相关资料
支付宝加油
商家费率申请
开发 > 服务端 > 其他通用产品 > 私域营销 >  >  >  > 查询活动详情接口
收藏
订阅更新
我的文档
设置
通过此接口可以查询活动详情,包括支付券和商家券活动。

公共请求参数

参数类型是否必选最大长度描述示例值
app_idstring必选32
支付宝分配给开发者的应用id
2014072300007148
methodstring必选128
接口名称
alipay.marketing.activity.query
formatstring可选40
仅支持json
json
charsetstring必选10
请求使用的编码格式,如utf-8,gbk,gb2312等
utf-8
sign_typestring必选10
商户生成签名字符串所使用的签名算法类型,目前支持rsa2和rsa,推荐使用rsa2
rsa2
signstring必选344
商户请求参数的签名串,详见签名
详见示例
timestampstring必选19
发送请求的时间,格式"yyyy-mm-dd hh:mm:ss"
2014-07-24 03:07:50
versionstring必选3
调用的接口版本,固定为:1.0
1.0
app_auth_tokenstring可选40
biz_contentstring必选
请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档

业务请求参数

activity_id|活动 id必选string(128)
【描述】活动id
【示例值】2016042700826004508401111111
merchant_access_mode|商户接入模式必选string(32)
【描述】商户接入模式。
【枚举值】
商户自接入模式: self_mode
服务商代接入模式: agency_mode
【注意事项】选择服务商代接入模式需配合 app_auth_token 代调用使用
【示例值】self_mode
merchant_id|商户pid可选string(32)
【描述】商户pid,默认为当前接口调用商户。
【注意事项】接口调用者必须有商户代运营权限。 代运营授权流程https://opendocs.alipay.com/mini/01hm6i#代运营授权
【示例值】2088202967380463
常见请求示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.marketing.activity.query&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
 -f 'biz_content={
	"activity_id":"2016042700826004508401111111",
	"merchant_access_mode":"agency_mode"
}' 
说明:本示例仅供参考。

公共响应参数

参数类型是否必选最大长度描述示例值
codestring必选-
网关返回码,
40004
msgstring必选-
网关返回码描述,
business failed
sub_codestring可选-
业务返回码,参见具体的api接口文档
acq.trade_has_success
sub_msgstring可选-
业务返回码描述,参见具体的api接口文档
交易已被支付
signstring必选-
签名,
dzxh8eetuahoye3w1j poiphfdxoybfunn1lket/v7p4zjdyojwea6izs6hz0ydw5cp/viufub5i0/v5wens3oyr8zredqo6d futdlhdc efyckiqhbxizgngpdpdfp1pis7bdhhzrszhbrqb7o4k3dxc aanfauu4v6zdwczo=

业务响应参数

activity_base_info|活动基础信息必选activitybaseinfo
【描述】活动基础信息
activity_id|活动 id必选string(128)
【描述】活动id
【示例值】2016042700826004508401111111
belong_merchant_info|券活动归属的商户信息必选belongmerchantinfo
【描述】商家券活动归属的商户信息
【注意事项】自研商户可以不传,服务商身份接入时必传
merchant_id|商户id必选string(32)
【描述】商户id
【注意事项】 1、服务商代运营模式必传 2、服务商代运营模式下服务商必须与商户建立代运营授权关系。
【示例值】2088102111111111
activity_status|活动状态必选string(32)
【描述】活动状态。活动已激活,表示活动已经生效,等到活动开始(publish_start_time)之后用户就可以参与活动。活动已暂停,表示商户临时暂停该活动,该状态下用户不能参与活动。活动已结束,表示商户主动停止活动或活动到期结束(publish_end_time)不能再进行领取或修改等操作。
【枚举值】
活动已激活: active
活动已暂停: pause
活动已结束: finished
【注意事项】1.该值为空,说明活动还未创建成功。可以使用 activity_operation_status字段判断活动是否处于creating状态。
【示例值】active
voucher_send_mode_info|券发放模式必选vouchersendmodeinfo
【描述】券发放模式
voucher_send_mode|券发放模式必选string(32)
【描述】券发放模式
【枚举值】
团购售卖模式: sale_mode
直领模式: direct_send_mode
券包售卖: voucher_package_sale_mode
【示例值】direct_send_mode
voucher_send_rule_info|券发放规则必选vouchersendruleinfo
【描述】券发放规则
quantity|发行券的数量必选number(32)
【描述】发行券的数量。
【注意事项】code_mode=merchant_upload模式下数量必须为0。其他模式下该数值必须是大于0的整数。
【示例值】100
natural_person_limit|是否做身份证号限制必选boolean(8)
【描述】是否开启自然人领取限制。 自然人表示按照身份证纬度进行领取限制。
【示例值】false
phone_number_limit|是否开启电话号码领取限制必选boolean(8)
【描述】是否开启电话号码领取限制。
【示例值】false
real_name_limit|支付宝实名限制必选boolean(8)
【描述】限制支付宝实名用户才能领取支付券,默认为false表示不限制 枚举值 true\false
【示例值】false
publish_start_time|券发放开始时间必选date(19)
【描述】券发放开始时间。 格式为:yyyy-mm-dd hh:mm:ss
【示例值】2017-01-01 00:00:01
publish_end_time|券发放结束时间必选date(19)
【描述】券发放结束时间。 格式为:yyyy-mm-dd hh:mm:ss
【示例值】2017-01-29 23:59:59
max_quantity_by_day|单天最大发券数量可选number(10)
【描述】设置此字段,允许指定单天最大发券数量。
【注意事项】每天发放张数*活动天数应小于等于优惠券发放总量。
【示例值】10
quantity_limit_per_user|每人领取限制可选number(10)
【描述】每人领取限制。
【注意事项】默认按照支付宝账号进行领取限制; 不填写或填入0表示没有领取限制。
【示例值】100
quantity_limit_per_user_period_type|每人领取周期类型可选string(32)
【描述】周期限领配置,限制每人在固定周期内领取张数(voucher_quantity_limit_per_user),默认life_cycle。
【枚举值】
每天: day
每周: week
每月: month
【示例值】life_cycle
voucher_sale_mode_info|券售卖信息特殊可选vouchersalemodeinfo
【描述】券售卖信息
sale_amount|用户购买优惠券需要支付的金额可选price(16)
【描述】用户购买优惠券需要支付的金额
【注意事项】币种为人民币,单位为元。小数点以后最多保留两位。取值范围:0.1<=x<=3000。
【示例值】50.00
refundable|购买的优惠券是否允许退款可选boolean(8)
【描述】购买的优惠券是否允许退款,不填默认否。枚举值: true:是 false:否
【示例值】false
overdue_refundable|是否过期自动退可选boolean(8)
【描述】是否支持优惠券过期后,自动退款给用户,不填默认否。枚举值: true:是 false:否 自动退款功能需要服务商在优惠券过期时,主动调用alipay.marketing.activity.order.refund接口进行退款。 如果配置优惠券时选择了过期自动退款,但是实际券过期后,服务商没有进行退款,那么用户投诉后,需要服务商进行解决。
【示例值】false
voucher_package_mode_info|券包信息特殊可选voucherpackagemodeinfo
【描述】券包信息
voucher_package_id|券包id必选string(64)
【描述】券包id,对应alipay.marketing.activity.voucherpackage.query中voucher_package_id。
【示例值】ip20220628016671405804297103167741
voucher_deduct_info|券优惠抵扣信息必选voucherdeductinfo
【描述】券优惠抵扣信息
voucher_type|券类型必选string(32)
【描述】券类型。
【枚举值】
满减券: fix_voucher
折扣券: discount_voucher
特价券: special_voucher
【示例值】fix_voucher
fix_voucher_info|满减券详情特殊可选fixvoucherinfo
【描述】满减券详情
【注意事项】券类型为满减券时必传。
【必选条件】voucher_type = fix_voucher必传
amount|券面额必选price(16)
【描述】面额,每张代金券可以抵扣的金额
【注意事项】币种为人民币,单位为元。小数点以后最多保留两位。 取值范围:0.1<=x<=3000
【示例值】50.00
floor_amount|门槛金额可选price(16)
【描述】门槛金额。该字段不填写,认为无门槛
【注意事项】只有当订单金额大于等于门槛金额时券才能使用。 币种为人民币,单位为元。小数点以后最多保留两位。 设置门槛:取值范围:0.1<=x<= 50000。 如果设置了门槛金额,则必须大于等于0.1,不可以等于0
【示例值】1000.00
discount_voucher_info|折扣券详情特殊可选discountvoucherinfo
【描述】折扣券详情
【注意事项】券类型 voucher_type 为折扣券 discount_voucher 时必传。
【必选条件】voucher_type=discount_voucher时必传
discount|折扣率必选string(12)
【描述】折扣率
【注意事项】取值范围:0.1<=x<=9.9,比如:6.5折填入6.5。
【示例值】6.5
ceiling_amount|封顶金额必选price(16)
【描述】封顶金额
【注意事项】币种为人民币,单位为元; 小数点以后最多保留两位; 取值范围:0.1<=x<=15000;
【示例值】50.00
floor_amount|门槛金额可选price(16)
【描述】门槛金额
【注意事项】币种为人民币,单位为元;小数点以后最多保留两位;取值范围:0.1<=x<= 50000; 说明:该字段可不填,认为无门槛。
【示例值】1000.00
special_voucher_info|特价券详情特殊可选specialvoucherinfo
【描述】特价券详情
【注意事项】券类型voucher_type为特价券,special_voucher时必传
【必选条件】券类型 voucher_type 为特价券 special_voucher 时必传。
special_amount|特价必选price(16)
【描述】特价,即:原价-特价=优惠金额。
限制:
币种为人民币,单位为元。小数点以后最多保留两位; 取值范围:0<=x<=999; 原价必须大于特价,即:origin_amount>special_amount;
【注意事项】币种为人民币,单位为元。小数点以后最多保留两位; 取值范围:0<=x<=999; 原价必须大于特价,即:origin_amount>special_amount;
【示例值】10.00
floor_amount|门槛金额可选price(16)
【描述】门槛金额
【注意事项】币种为人民币,单位为元;小数点以后最多保留两位;取值范围:0.1<=x<= 50000; 说明:该字段可不填,认为无门槛。
【示例值】1000.00
exchange_voucher_info|兑换券详情可选exchangevoucherinfo
【描述】兑换券详情
【注意事项】券类型为兑换券时必传。
amount|券的价值可选price(16)
【描述】券的价值
【注意事项】币种为人民币,单位为元。小数点以后最多保留两位。 取值范围:0.1<=x<=3000
【示例值】100.00
floor_amount|门槛金额可选price(16)
【描述】优惠门槛金额
【注意事项】币种为人民币,单位为元。小数点以后最多保留两位。 设置门槛:取值范围:0.1<=x<= 50000。 如果设置了门槛金额,则必须大于等于0.1,不可以等于0
【示例值】1000.00
biz_type|兑换券业务类型可选string(64)
【描述】兑换券业务类型
【枚举值】
团购券: group_buy_exchange_voucher
代金券: fix_exchange_voucher
【示例值】group_buy_exchange_voucher
voucher_use_rule_info|券核销规则必选voucheruseruleinfo
【描述】券核销规则
voucher_use_time_info|券核销时间必选voucherusetimeinfo
【描述】券核销时间
period_type|券有效期必选string(32)
【描述】券有效期。
【枚举值】
绝对时间: absolute
相对时间: relative
【示例值】absolute
absolute_period_info|券绝对时间可用特殊可选voucherabsoluteperiodinfo
【描述】券绝对时间可用
valid_begin_time|券可使用的开始时间必选date(19)
【描述】券可使用的开始时间。 格式为:yyyy-mm-dd hh:mm:ss
【示例值】2017-01-10 00:00:00
valid_end_time|券可使用的结束时间必选date(19)
【描述】券可使用的结束时间。 格式为yyyy-mm-dd hh:mm:ss
【注意事项】券可使用的结束时间valid_end_time 必须大于 券的发放结束时间 publish_end_time。
【示例值】2017-01-13 23:59:59
time_restrict_info|核销时间限制可选timerestrictinfo
【描述】核销时间限制
usable_period_info|可用时间段可选voucherusetimeruleinfo[]
【描述】可用时间段
rule_type|规则类型必选string(32)
【描述】规则类型
【枚举值】
周期类型: week
日期类型: date
法定节假日类型: holiday
【示例值】week
week_rule_info|周期规则特殊可选weekruleinfo
【描述】周期规则。当rule_type = week时,不能为空
week_day|星期数必选string(32)
【描述】星期数,以“,”连接多个星期数
【示例值】1,2
time_range_info|时间段必选timerangeinfo
【描述】时间段
begin_time|开始时间必选string(8)
【描述】开始时间 格式:hh:mm:ss
【示例值】00:00:00
end_time_info|结束时间必选endtimeinfo
【描述】结束时间,可设置当日或次日结束,例如:22:00~次日07:00
end_time_type|结束时间类型必选string(32)
【描述】结束时间类型
【枚举值】
当日: same_day
次日: next_day
【示例值】next_day
end_time|结束时间必选string(8)
【描述】结束时间 格式:hh:mm:ss
【示例值】23:59:59
disable_period_info|不可用时间段可选voucherusetimeruleinfo[]
【描述】不可用时间段
rule_type|规则类型必选string(32)
【描述】规则类型
【枚举值】
周期类型: week
日期类型: date
法定节假日类型: holiday
【示例值】date
date_rule_info|日期规则特殊可选dateruleinfo
【描述】日期规则。当ruletype = date时,不能为空
date_range_info|日期范围必选daterangeinfo
【描述】日期范围
begin_date|开始日期必选string(12)
【描述】开始日期 格式:yyyy-mm-dd
【示例值】2023-02-01
end_date|结束日期必选string(12)
【描述】结束日期 格式:yyyy-mm-dd
【示例值】2023-03-31
time_range_info|时间段必选timerangeinfo
【描述】时间段
begin_time|开始时间必选string(8)
【描述】开始时间 格式:hh:mm:ss
【示例值】00:00:00
end_time_info|结束时间必选endtimeinfo
【描述】结束时间,可设置当日或次日结束,例如:22:00~次日07:00
end_time_type|结束时间类型必选string(32)
【描述】结束时间类型
【枚举值】
当日: same_day
次日: next_day
【示例值】next_day
end_time|结束时间必选string(8)
【描述】结束时间 格式:hh:mm:ss
【示例值】23:59:59
holiday_rule_info|节假日规则特殊可选holidayruleinfo
【描述】节假日规则。当ruletype = holiday时,不能为空
time_range_info|时间段必选timerangeinfo
【描述】时间段
begin_time|开始时间必选string(8)
【描述】开始时间 格式:hh:mm:ss
【示例值】00:00:00
end_time_info|结束时间必选endtimeinfo
【描述】结束时间,可设置当日或次日结束,例如:22:00~次日07:00
end_time_type|结束时间类型必选string(32)
【描述】结束时间类型
【枚举值】
当日: same_day
次日: next_day
【示例值】next_day
end_time|结束时间必选string(8)
【描述】结束时间 格式:hh:mm:ss
【示例值】23:59:59
relative_period_info|券相对时间特殊可选voucherrelativeperiodinfo
【描述】券相对时间
wait_days_after_receive|用户领券后需要等待 n 天生效必选number(16)
【描述】用户领券后需要等待n天,券才可以生效。
字段值为0表示用户领券后立刻生效。
【示例值】1
valid_days_after_receive|券生效后 n 天内可以使用必选number(10)
【描述】券生效后n天内可以使用。 可以配合wait_days_after_receive字段使用。
【注意事项】valid_days_after_receive必须大于0。
【示例值】1
time_restrict_info|核销时间限制可选timerestrictinfo
【描述】核销时间限制
usable_period_info|可用时间段可选voucherusetimeruleinfo[]
【描述】可用时间段
rule_type|规则类型必选string(32)
【描述】规则类型
【枚举值】
周期类型: week
日期类型: date
法定节假日类型: holiday
【示例值】week
week_rule_info|周期规则特殊可选weekruleinfo
【描述】周期规则。当rule_type = week时,不能为空
week_day|星期数必选string(32)
【描述】星期数,以“,”连接多个星期数
【示例值】1,2
time_range_info|时间段必选timerangeinfo
【描述】时间段
begin_time|开始时间必选string(8)
【描述】开始时间 格式:hh:mm:ss
【示例值】00:00:00
end_time_info|结束时间必选endtimeinfo
【描述】结束时间,可设置当日或次日结束,例如:22:00~次日07:00
end_time_type|结束时间类型必选string(32)
【描述】结束时间类型
【枚举值】
当日: same_day
次日: next_day
【示例值】next_day
end_time|结束时间必选string(8)
【描述】结束时间 格式:hh:mm:ss
【示例值】23:59:59
disable_period_info|不可用时间段可选voucherusetimeruleinfo[]
【描述】不可用时间段
rule_type|规则类型必选string(32)
【描述】规则类型
【枚举值】
周期类型: week
日期类型: date
法定节假日类型: holiday
【示例值】date
date_rule_info|日期规则特殊可选dateruleinfo
【描述】日期规则。当ruletype = date时,不能为空
date_range_info|日期范围必选daterangeinfo
【描述】日期范围
begin_date|开始日期必选string(12)
【描述】开始日期 格式:yyyy-mm-dd
【示例值】2023-02-01
end_date|结束日期必选string(12)
【描述】结束日期 格式:yyyy-mm-dd
【示例值】2023-03-31
time_range_info|时间段必选timerangeinfo
【描述】时间段
begin_time|开始时间必选string(8)
【描述】开始时间 格式:hh:mm:ss
【示例值】00:00:00
end_time_info|结束时间必选endtimeinfo
【描述】结束时间,可设置当日或次日结束,例如:22:00~次日07:00
end_time_type|结束时间类型必选string(32)
【描述】结束时间类型
【枚举值】
当日: same_day
次日: next_day
【示例值】next_day
end_time|结束时间必选string(8)
【描述】结束时间 格式:hh:mm:ss
【示例值】23:59:59
holiday_rule_info|节假日规则特殊可选holidayruleinfo
【描述】节假日规则。当ruletype = holiday时,不能为空
time_range_info|时间段必选timerangeinfo
【描述】时间段
begin_time|开始时间必选string(8)
【描述】开始时间 格式:hh:mm:ss
【示例值】00:00:00
end_time_info|结束时间必选endtimeinfo
【描述】结束时间,可设置当日或次日结束,例如:22:00~次日07:00
end_time_type|结束时间类型必选string(32)
【描述】结束时间类型
【枚举值】
当日: same_day
次日: next_day
【示例值】next_day
end_time|结束时间必选string(8)
【描述】结束时间 格式:hh:mm:ss
【示例值】23:59:59
voucher_max_use_times|券最大核销次数可选number(16)
【描述】券最大核销次数
【示例值】1
voucher_display_pattern_info|券展示信息必选voucherdisplaypatterninfo
【描述】券展示信息
brand_name|商户品牌名称必选string(12)
【描述】商户品牌名称。 如果不设置品牌名称,则默认使用支付宝商家系统中维护的商家别名。 如果没有维护商家别名,则使用默认名称: 商家优惠。 用户领取优惠券后,品牌名称会对用户进行展示。
【注意事项】服务商平台模式即belong_merchant_info.business_type为isv时必传。
【示例值】商家优惠
brand_logo_url|商家品牌logo链接必选string(255)
【描述】商家品牌logo链接
【示例值】https://gw.alipayobjects.com/mdn/rms_9822d7/afts/img/a*1f4esaaphrqaaaaaaaaaaabkarqnaq
voucher_name|对消费者展示的券(商品)名称必选string(20)
【描述】券名称
【注意事项】兑换券必传
【示例值】满10减1券
voucher_description|券详细使用说明必选string(1000)
【描述】券详细使用说明。
【示例值】1、本券不可兑换现金,不可找零。2、每个用户最多可以领取1张。3、如果订单发生退款,优惠券无法退还。
以下参数 二选一 必选
customer_service_mobile|客服电话string(20)
【描述】客服电话
【注意事项】客服电话和客服链接必须二选一
【示例值】81xxxxxxx
customer_service_url|客服链接string(255)
【描述】客服链接
【注意事项】客服电话和客服链接必须二选一
【示例值】alipay://xxxx
voucher_image_url|券封面链接可选string(255)
【描述】券封面链接
【示例值】https://gw.alipayobjects.com/mdn/rms_9822d7/afts/img/a*1f4esaaphrqaaaaaaaaaaabkarqnaq
voucher_detail_image_urls|券详情图链接可选string[](800)
【描述】券详情链接
【示例值】["https://gw.alipayobjects.com/mdn/rms_9822d7/afts/img/a*1f4esaaphrqaaaaaaaaaaabkarqnaq"]
voucher_available_scope_info|可用范围可选voucheravailablescopeinfo
【描述】可用范围
voucher_available_goods_info|券可用商品可选voucheravailablegoodsinfo
【描述】券可用商品
goods_name|商品名称可选string(32)
【描述】商品名称。
【注意事项】兑换券、特价券必填
【示例值】美味甜甜圈
goods_description|商品描述可选string(120)
【描述】商品描述
【示例值】美味甜甜圈很美味
origin_amount|原价可选price(16)
【描述】商品原价
【注意事项】特价券必填
【示例值】100.00
voucher_customer_guide_info|引导详情可选vouchercustomerguideinfo
【描述】券引导详情
voucher_use_guide_info|券核销详情可选voucheruseguideinfo
【描述】券核销详情
use_guide_mode|使用引导模式可选string[](300)
【描述】使用引导模式
【枚举值】
券码扫码核销: offline_code
小程序线上核销: mini_app
跳转付款码支付核销: scan_code
【示例值】["mini_app"]
mini_app_use_guide_info|小程序核销引导可选voucherminiappuseguideinfo
【描述】小程序核销引导
以下参数 二选一 必选
mini_app_url|指定跳转到mini_app_id时的具体页面路径string(64)
【描述】小程序核销链接
【注意事项】mini_app_service_codes与mini_app_url只能二选一
【示例值】alipays://platformapi/startapp?appid=xxxx
mini_app_service_codes|小程序服务编码string[](1024)
【描述】小程序服务编码。取值来源:通过接口创建服务后获取。
【注意事项】mini_app_service_codes与mini_app_url只能二选一
【示例值】["2020030921000303380758"]
响应示例
{
    "alipay_marketing_activity_query_response": {
        "code": "10000",
        "msg": "success",
        "activity_base_info": {
            "activity_id": "2016042700826004508401111111",
            "belong_merchant_info": {
                "merchant_id": "2088102111111111"
            },
            "activity_status": "active"
        },
        "voucher_send_mode_info": {
            "voucher_send_mode": "direct_send_mode",
            "voucher_sale_mode_info": {
                "sale_amount": "50.00",
                "refundable": false,
                "overdue_refundable": false
            },
            "voucher_package_mode_info": {
                "voucher_package_id": "ip20220628016671405804297103167741"
            },
            "voucher_send_rule_info": {
                "quantity": 100,
                "max_quantity_by_day": 10,
                "quantity_limit_per_user": 100,
                "quantity_limit_per_user_period_type": "life_cycle",
                "natural_person_limit": false,
                "phone_number_limit": false,
                "real_name_limit": false,
                "publish_start_time": "2017-01-01 00:00:01",
                "publish_end_time": "2017-01-29 23:59:59"
            }
        },
        "voucher_deduct_info": {
            "voucher_type": "fix_voucher",
            "fix_voucher_info": {
                "amount": "50.00",
                "floor_amount": "1000.00"
            },
            "discount_voucher_info": {
                "discount": "6.5",
                "ceiling_amount": "50.00",
                "floor_amount": "1000.00"
            },
            "special_voucher_info": {
                "special_amount": "10.00",
                "floor_amount": "1000.00"
            },
            "exchange_voucher_info": {
                "amount": "100.00",
                "floor_amount": "1000.00",
                "biz_type": "group_buy_exchange_voucher"
            }
        },
        "voucher_use_rule_info": {
            "voucher_max_use_times": 1,
            "voucher_use_time_info": {
                "period_type": "absolute",
                "absolute_period_info": {
                    "valid_begin_time": "2017-01-10 00:00:00",
                    "valid_end_time": "2017-01-13 23:59:59",
                    "time_restrict_info": {
                        "usable_period_info": [
                            {
                                "rule_type": "week",
                                "week_rule_info": {
                                    "week_day": "1,2",
                                    "time_range_info": {
                                        "begin_time": "00:00:00",
                                        "end_time_info": {
                                            "end_time_type": "next_day",
                                            "end_time": "23:59:59"
                                        }
                                    }
                                }
                            }
                        ],
                        "disable_period_info": [
                            {
                                "rule_type": "date",
                                "date_rule_info": {
                                    "date_range_info": {
                                        "begin_date": "2023-02-01",
                                        "end_date": "2023-03-31"
                                    },
                                    "time_range_info": {
                                        "begin_time": "00:00:00",
                                        "end_time_info": {
                                            "end_time_type": "next_day",
                                            "end_time": "23:59:59"
                                        }
                                    }
                                },
                                "holiday_rule_info": {
                                    "time_range_info": {
                                        "begin_time": "00:00:00",
                                        "end_time_info": {
                                            "end_time_type": "next_day",
                                            "end_time": "23:59:59"
                                        }
                                    }
                                }
                            }
                        ]
                    }
                },
                "relative_period_info": {
                    "wait_days_after_receive": 1,
                    "valid_days_after_receive": 1,
                    "time_restrict_info": {
                        "usable_period_info": [
                            {
                                "rule_type": "week",
                                "week_rule_info": {
                                    "week_day": "1,2",
                                    "time_range_info": {
                                        "begin_time": "00:00:00",
                                        "end_time_info": {
                                            "end_time_type": "next_day",
                                            "end_time": "23:59:59"
                                        }
                                    }
                                }
                            }
                        ],
                        "disable_period_info": [
                            {
                                "rule_type": "date",
                                "date_rule_info": {
                                    "date_range_info": {
                                        "begin_date": "2023-02-01",
                                        "end_date": "2023-03-31"
                                    },
                                    "time_range_info": {
                                        "begin_time": "00:00:00",
                                        "end_time_info": {
                                            "end_time_type": "next_day",
                                            "end_time": "23:59:59"
                                        }
                                    }
                                },
                                "holiday_rule_info": {
                                    "time_range_info": {
                                        "begin_time": "00:00:00",
                                        "end_time_info": {
                                            "end_time_type": "next_day",
                                            "end_time": "23:59:59"
                                        }
                                    }
                                }
                            }
                        ]
                    }
                }
            }
        },
        "voucher_display_pattern_info": {
            "brand_name": "商家优惠",
            "brand_logo_url": "https://gw.alipayobjects.com/mdn/rms_9822d7/afts/img/a*1f4esaaphrqaaaaaaaaaaabkarqnaq",
            "voucher_name": "满10减1券",
            "voucher_description": "1、本券不可兑换现金,不可找零。2、每个用户最多可以领取1张。3、如果订单发生退款,优惠券无法退还。",
            "voucher_image_url": "https://gw.alipayobjects.com/mdn/rms_9822d7/afts/img/a*1f4esaaphrqaaaaaaaaaaabkarqnaq",
            "voucher_detail_image_urls": [
                "https://gw.alipayobjects.com/mdn/rms_9822d7/afts/img/a*1f4esaaphrqaaaaaaaaaaabkarqnaq"
            ],
            "customer_service_mobile": "81xxxxxxx",
            "customer_service_url": "alipay://xxxx"
        },
        "voucher_available_scope_info": {
            "voucher_available_goods_info": {
                "goods_name": "美味甜甜圈",
                "goods_description": "美味甜甜圈很美味",
                "origin_amount": "100.00"
            }
        },
        "voucher_customer_guide_info": {
            "voucher_use_guide_info": {
                "use_guide_mode": [
                    "mini_app"
                ],
                "mini_app_use_guide_info": {
                    "mini_app_url": "alipays://platformapi/startapp?appid=xxxx",
                    "mini_app_service_codes": [
                        "2020030921000303380758"
                    ]
                }
            }
        }
    },
    "sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}
说明:本示例仅供参考。

公共错误码

业务错误码

错误码错误描述凯发app官方网站的解决方案
system_error服务器异常
可能发生了网络或者系统异常,导致服务调用失败,商户可以用同样的请求发起重试
invalid_parameter参数有误参数非法
请根据接口返回的参数非法的具体错误信息,修改参数后进行重试。
activity_not_active活动未激活
当前活动不是激活状态,不能查询
activity_not_permission商户没有该活动的权限
当前商户没有该活动的查询权限。
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
为开发者能享受更简单的协议处理逻辑、更丰富的开源工具配套、更低的接口响应时延,支付宝开放平台推出符合oas3.0规范的,助力开发体验。新版本文档请点击“查看v3版本”进行访问。
网站地图