私域营销
通过此接口可以查询活动详情,包括支付券和商家券活动。
公共请求参数
业务请求参数
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"
}'
说明:本示例仅供参考。
公共响应参数
业务响应参数
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;
【注意事项】币种为人民币,单位为元。小数点以后最多保留两位; 取值范围: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表示用户领券后立刻生效。
字段值为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 | 商户没有该活动的权限 | 当前商户没有该活动的查询权限。 |