更新时间：2025-07-17 14:38:15配置项检测工具收藏订阅更新我的文档设置接入检测（即可查看检测结果）若有未通过的接入检测项，接口将无法调通去登录返回文档资源关系ordervoucheractivity（商家券活动）商家举办的一场特定优惠规则的营销活动，以券的形式将活动权益发放出去。商家券活动的字段列表参数类型描述activity_idstring活动 id。activity_lite_infosactivityliteinfo[]活动摘要信息。activity_namestring活动名称，不对用户进行展示，仅供商家在后台管理活动使用。activity_operation_statusstring活动操作状态。枚举值： ●creating：创建中。 ●modifying：修改中。 ●appending：追加中。 ●finisheing：终止中。 注意：该值为空，说明活动当前没有正在执行中的操作。activity_statusstring活动状态。 枚举值：●active：已激活（活动正常运行）。 ●finished：已终止（商家终止活动，不可再发放）。 注意：该值为空，说明活动还未创建成功。可以使用 activity_operation_status 字段判断活动是否处于 creating 状态。app_infosactivityappinfo[]可用小程序列表。belong_merchant_idstring归属商户 pid。belong_merchant_infobelongmerchantinfo活动归属商户信息。限制：服务商身份接入时必传。biz_tagstring商家券业务标签，影响商家券对 c 端用户的展示形式。枚举值： ● group_buy_exchange_voucher：兑换券团购场景。●fix_exchange_voucher：兑换券代金场景。code_modestring券码模式，枚举值：●merchant_upload：商户上传自定义 code，发券时系统随机选取上传的券 code 发放。●merchant_api：发奖时指定券码发奖，此模式无须提前上传券码（该模式暂时只针对 exchange_voucher 生效）。customer_guidecustomerguide券自定义入口。goods_infosactivitygoodsinfo[]商品编码列表。merchant_idstring商户 pid，默认为当前接口调用商家。注意：接口调用者必须有商户代运营权限，可查看 。merchant_infosactivitymerchantinfo[]可用商户列表。mini_app_idstring小程序 id。out_biz_nostring外部业务单号，用作幂等控制。幂等作用：参数不变的情况下，再次请求返回与上一次相同的结果。外部接入方需保证业务单号唯一。publish_end_timedate券发放结束时间。格式为：yyyy-mm-dd hh:mm:ss。publish_start_timedate券发放开始时间。格式为：yyyy-mm-dd hh:mm:ss。shop_idstring支付宝侧蚂蚁店铺 id。shop_infosactivityshopinfo[]可用门店列表。voucher_display_infovoucherdisplayinfo券展示信息。voucher_quantitynumber发券数量上限。券总预算值，不可减少，只能增加。 注意：券总预算小于或等于 999999 code_mode= merchant_upload 的情况下， voucher_quantity 需要与导入码的总数量保持一致。voucher_send_rulevouchersendruledetail券发放规则。voucher_typestring券类型，枚举值：●fix_voucher：满减券。●discount_voucher：折扣券。●special_voucher：特价券。●exchange_voucher: 兑换券。voucher_use_rulevoucheruserule券核销规则。voucher_use_rule_resultordervoucheruseruleresult核销规则请求结果。商家券活动支持的操作api 中文名称api 英文名称创建商家券活动alipay.marketing.activity.ordervoucher.create商家券活动创建通知alipay.marketing.activity.message.created修改商家券活动基本信息alipay.marketing.activity.ordervoucher.modify商家券活动修改通知alipay.marketing.activity.message.modified查询商家券活动alipay.marketing.activity.ordervoucher.query停止商家券活动alipay.marketing.activity.ordervoucher.stop商家券活动停止通知alipay.marketing.activity.message.stopped修改商家券活动发券数量上限alipay.marketing.activity.ordervoucher.append商家券活动预算追加通知alipay.marketing.activity.message.appended条件查询活动列表alipay.marketing.activity.batchquery查询活动详情alipay.marketing.activity.query商家营销活动咨询alipay.marketing.activity.consult查询活动可用小程序alipay.marketing.activity.app.batchquery查询活动可用门店alipay.marketing.activity.shop.batchquery查询活动适用商品alipay.marketing.activity.goods.batchqueryordervoucher（商家券）商家券活动发放的符合活动规则的优惠券，每张优惠券有不同的券码。商家券的字段列表参数类型描述voucher_codestring券码，单个 code 最长 64 位。 code 允许包含的字符有 0-9、a-z、a-z、-、_、 、=、|。activity_idstring活动 id。belong_merchant_idstring券归属商户。biz_dtstring外部优惠券的核销时间，用于流水记录。格式为：yyyy-mm-dd hh:mm:ss。fail_countstring导入失败的券码数量。goods_detailgoodsdetaildto[]商品明细信息。 说明：若当前交易中存在商品信息，则建议传入商品明细信息。out_biz_nostring外部业务单号，用作幂等控制。 幂等作用： 参数不变的情况下，再次请求返回与上一次相同的结果。 外部接入方需保证业务单号唯一。real_shop_idstring用户核销优惠券的代运营商业关系门店 id。store_idstring用户核销优惠券的支付门店 id。success_countnumber已经导入的券码数量。trade_channelstring[]交易渠道。枚举值： ●zhifubao_trade_channel：支付宝交易渠道。●wx_trade_channel：微信交易渠道。●other_trade_channel：其他交易渠道。trade_nostring该交易在支付宝系统中的交易流水号。 注意：若用户使用支付宝为交易的渠道，本参数必填。user_id（open_id）string支付宝用户 id。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看openid配置申请。user_voucher_infosuservoucherinfo[]用户券实例。voucher_display_infocommonvoucherdisplayinfo券展示信息。voucher_namestring券名称。voucher_send_rulecommonvouchersendrule券发放规则。voucher_statusstring券状态，枚举值：●sended：可用。●used：已核销。●expired：已过期（可查询 6 个月内数据）。voucher_use_rulecommonvoucheruserule券核销规则。商家券支持的操作api 中文名称api 英文名称取消券核销状态alipay.marketing.activity.ordervoucher.refund同步券核销状态alipay.marketing.activity.ordervoucher.use同步商家券券码alipay.marketing.activity.ordervoucher.codedeposit统计商家券券码数量alipay.marketing.activity.ordervoucher.codecount条件查询用户券alipay.marketing.activity.user.batchqueryvoucher查询用户券详情alipay.marketing.activity.user.queryvoucher商家券领取通知alipay.marketing.activity.message.received券核销消息alipay.marketing.activity.message.used券过期消息alipay.marketing.activity.message.expiredmrshop（蚂蚁店铺）蚂蚁商家可通过接口经营单元（如门店）的创建、查询等功能，方便服务商帮助商家创建门店、管理门店信息。蚂蚁店铺的字段列表参数类型描述shop_idstring蚂蚁店铺 idbusiness_addressaddressinfo经营地址。business_timeshopbusinesstime店铺经营时间。cert_imagestring营业执照图片。contact_infoscontactinfo联系人信息。ip_role_idstring商户角色 id，表示将要开的店属于哪个商户角色。对于直连开店场景，填写商户 pid；对于间连开店场景（线上、线下、直付通），填写商户 smid。若没传 shop_id，则本字段与 store_id 均必填。mccstring[]商户 mcc 类目。qualificationsindustryqualificationinfo[]行业特殊资质。shop_categorystring店铺类目，取值可查看 中的三级门店类目。shop_infosshopqueryopenapivo[]门店详情。shop_namestring店铺名称。shop_typestring店铺经营类型，枚举值：●01：表示直营。●02：表示加盟。store_idstring门店编号。蚂蚁店铺支持的操作api 中文名称api 英文名称蚂蚁店铺创建ant.merchant.expand.shop.create店铺保存审核通过消息ant.merchant.expand.shop.save.passed店铺保存拒绝消息ant.merchant.expand.shop.save.rejected修改蚂蚁店铺ant.merchant.expand.shop.modify商户申请单查询ant.merchant.expand.order.query店铺查询ant.merchant.expand.shop.query店铺分页查询ant.merchant.expand.shop.page.query蚂蚁店铺关闭ant.merchant.expand.shop.closemcc（商户类目）商户类目信息。商户类目的字段列表参数类型描述mccstringmcc 类目。mcc_info_listmccqueryinfo[]mcc 查询信息结果列表。商户类目支持的操作api 中文名称api 英文名称商户 mcc 信息查询ant.merchant.expand.mcc.queryimage（商家图片）商家信息相关图片。商家图片的字段列表参数类型描述image_idstring图片 id。image_typestring图片格式，支持格式：bmp、jpg、jpeg、png、gif。商家图片支持的操作api 中文名称api 英文名称图片上传ant.merchant.expand.indirect.image.upload
