北京华网天下

微信支付（商户平台）卡券开发文档

2024-01-07

来源：网络整理

文章目录

介绍

除了微信公众平台提供的微信卡券外，微信支付商户平台还提供卡券相关功能，包括代金券和商户优惠券两大类。现在卡、优惠券用得不多，但更多的商户优惠券、代金券是用微信支付的；

微信支付卡券与微信公众平台卡券的区别：

微信公众平台优惠券：优惠券不能在支付时使用，必须先注销。商家会决定满了优惠券后减多少，然后再补多少。核销规则由商户自行定义。

微信支付商户优惠券：与微信公众平台卡券验证规则相同（但多了一种验证方式：支持跳转支付码支付验证）；

微信支付券：支付时即可使用，统一下单计算折扣。通过微信支付进行核销；

代金券

微信支付代金券业务基于微信支付，协助商户轻松实施营销优惠措施。对于一些有开发能力的商户，微信支付通过API接口提供了操作凭证的功能。

优惠券分类预充值优惠券

活动发起者需提前将优惠预算充值至商户余额中。活动期间产生的优惠资金将从余额中扣除，最终与用户实际支付的资金一起结算给商户。

商户实际收到金额=用户订单金额（例如：超过100元的订单负10。这意味着订单金额为100元，用户实际支付90元，商户实际收到100元）。

特征

优点：不影响商户实际收款，对账方便/无需开发，配置即用；缺点：占用资金、影响资金流动性/涉及财务税务手续较繁琐/不受渠道商支持

注意

免费充值券

活动创建者无需提前充值即可创建活动。用户享受折扣时，金额将直接从当前交易商户订单的实际金额中扣除。最终只有用户实际支付的资金才会与商户结算（免充值激活准则）。

商户实际收到金额=用户订单金额-优惠券折扣金额（例如：订单满100元减10。表示订单金额为100元，用户实际支付了90元，而商家实际收到90元（用户收到优惠券后，直接在付款中核销10元）

特征

优点：不占用资金；缺点：影响商户实际收入；

注意

优惠券发放通道二维码发放

微信支付券二维码发放仅适用于商户平台操作，不支持API接口。具体操作请参见下文【操作指引—商户平台操作—发放优惠券】。

营销活动优惠券

微信支付券营销活动的券发放仅适用于商户平台运营，不支持API接口。具体操作请参见下文【操作指引—商户平台操作—发放优惠券】。

先进的API接口发放优惠券

微信支付凭证API接口用于发放凭证。具体操作请参见下文【操作指引-商户平台操作-发放优惠券】。

使用核销方式付款时自动核销优惠券

目前，微信支付凭证仅支持支付时自动验证凭证。

操作说明

微信为商户/服务商提供了操作优惠券的商户平台和API接口，具体包括：

开发前准备激活凭证权限

使用商户平台的优惠券功能，您需要激活优惠券权限。操作路径：【登录微信支付商户平台->产品中心->预充值券->激活】。

下载API证书

商户使用优惠券时，需要安装证书。请在商户平台下载证书。

注意：

可调用接口的作用：每个接口都有不同的限制。请参考各接口的规则。调用时与需求有绑定关系。您可以在【微信支付商户平台->产品中心->开发配置】中进行绑定，与需要有对应关系的商户平台操作创建凭证

商户登录微信支付商户平台批量创建优惠券（操作路径：【微信支付商户平台—>营销中心—>创建全/单品优惠券]）。具体优惠券信息请参见“创建优惠券”。

激活优惠券

待激活的凭证存储在管理凭证草稿箱中。点击每个批次右上角的激活按钮即可查看详情并激活。激活的凭证将包含在操作中。激活的优惠券可以在有效期内或暂停前发放。

注意：激活前请确保账户有足够的预算，只有拥有**激活营销活动**权限的账户才能激活优惠券。

发放优惠券

运营中批量发放凭证的方式有二维码、营销活动、高级界面三种。前两者是通过商户平台发放的（如果优惠券开启了卡包功能，用户可以将优惠券添加到卡包中）。

管理优惠券

微信商户平台提供代金券管理功能。商户可以查看已发放的优惠券状态、修改、暂停发放、查看其发放和消费记录。具体操作请参见“优惠券管理”。

API接口操作创建凭证

调用该接口可以创建优惠券批次，包括预充值和免充值类型。

激活优惠券

优惠券创建成功后，调用该接口激活批量。

注意：

如果是预充值代金券，该批次的营销资金将在激活时从商户账户余额中锁定。

发放优惠券

商户平台/API完成优惠券创建后，可以使用优惠券发放接口发放优惠券。通过调用该接口，可以将指定批次下发给指定用户。优惠券发放场景可以是小程序、H5、APP等。

注意：

通过接口发放的优惠券不会自动进入微信卡包。如果您需要申请自动插卡包的能力，可以向微信支付行业运营同事了解申请流程（仅对部分商户开放）。代金券成功发放后，即使没有插入微信卡包，也不影响其使用（支付时会自动注销）。默认情况下，商户只能发放自己商户账户（调用优惠券发放接口的商户账户）创建的优惠券。如果您需要发放其他商户创建的优惠券，请参考Q1.管理优惠券

API接口提供凭证管理接口，包括：

具体接口使用详情请参见“优惠券管理API接口”。

商户优惠券

微信支付商户优惠券与微信商户公众平台免费优惠券类似。商户可以利用该功能在微信支付允许的范围内实现商户优惠券信息生成、发放、接收、取消的闭环，并利用数据对账、优惠券信息查询等配套功能完成商户功能，完成商户优惠券管理。

注意：

微信支付的商户优惠券功能目前仅通过API接口实现（仅适用于开放能力的商户），暂不支持商户平台页面配置和管理功能。

商户优惠券分类

目前商户优惠券支持满折券、打折券、兑换券三种折扣（相比公众平台，优惠券种类较少，无团购券）

满减优惠券

想要消费X元减X元（例如：消费10元送5元优惠券），商家可以在优惠券的适用范围字段中向用户说明该优惠券适用的商品（例如：适用于店内所有商品，不包括特殊商品或商品适用的XX品牌）。

折扣券

消费X元指定商品可享受X折优惠券。

兑换券

当您花费X元兑换商品时，商家可以使用兑换券包装时尚百货常见的小样（单品）免费兑换券（例如：可乐2元）或减额兑换券；商家可以在优惠券的适用范围字段中向用户说明该优惠券适用的商品（例如：XX品牌商品适用，但不适用于XX商品）。

优惠券发放渠道商户自有流量场景

有一定的开发量，适合使用开发能力的商家。微信支付支持在商户小程序（小程序优惠券发放插件）和H5网页（JS-API优惠券发放）中发放商户优惠券。

具体优惠券发放逻辑请参考以下【操作逻辑—>API接口操作—>发放商户优惠券】

注意：

小程序优惠券发放插件，该插件目前仅支持【微信支付商户优惠券】的发放，暂不支持【微信支付优惠券】的发放，请各商户特别关注。使用小程序发放商户优惠券时，商户小程序需要申请激活优惠券发放插件的权限才可以开发。 1个工作日完成申请审核。操作路径：【商户小程序—>设置—>第三方设置—>插件管理—>添加插件】微信支付平台流量场景

微信支付支持在支付友里（用户在商户支付页面支付成功）和附近优惠券（用户面对面支付成功）发放商户优惠券。对应的活动创建包括支付平台创建和API接口创建，分别适合无开发意向商户和有开发意向商户。

核销方式在线小程序核销（）

用户点击立即使用，跳转到商户小程序（需要添加小程序和路径）。商户系统后台请求查询当前用户微信卡包对应的所有商户优惠券信息，然后根据商户自身的优惠规则进行判断，然后调用验证接口调用用户微信中的商户优惠券状态卡包要验证。别针。

离线落码验证（）

用户前往商户线下门店，进入卡包找到指定优惠券，点击立即使用，跳转至优惠券详情二维码展示。使用二维码向商户出示商户优惠券。商户离线扫码器识别Code信息，调用后台验证接口，将用户微信卡包中对应商户优惠券的状态转为。

注：用户是否满足使用折扣的门槛条件，以及对应的折扣金额或商品，均由商户系统决定。如果满足相应要求，商户系统则请求微信支付系统验证商户优惠券。

微信支付支付码验证（）

点击立即使用，跳转至微信支付钱包支付码。具体核销流程请参见文件末尾的扩展部分——“”。

用户自助核销()

点击立即使用，跳转至用户自助核销界面（暂不支持用户自助核销）。

操作指南：开发前准备证书及签名准备

证书和签名的详细信息请参见：接口规则