1.总体说明
1.1 修订历史
|
文档版本 |
修订说明 |
|
20250416_01 |
1. 交易立减新增阶梯立减优惠类型 2. 新增出资授权列表查询、免充值商户授权H5等接口 |
|
20250321_01 |
1. 全面支持出资授权，增加运营/商服平台授权途径 2. 新增批量添加可用商户/授权文件接口 |
|
20250221_01 |
1.纯免充值活动调整为提交后直接转入投放，无需活动审核 2.支持券/礼品卡作废 |
|
20250206_01 |
新增出资授权 |
|
20250102_01 |
活动状态更新 |
|
20240930_01 |
1. 优惠券新增当面付快捷支付核销方式 2. 新增营销产品：交易立减、礼品卡 |
|
20240715_01 |
创建文档 |
1.2 本文读者
基础营销产品使用合作方，如收单商户、ISV、银行、通联内部业务系统人员等。
1.3 目的与范围
本文档主要介绍基础营销产品及其应用场景、业务流程、具体功能实现效果等内容。
2.平台简介
2.1 平台概述
基于通联基础支付产品能力，基础营销平台叠加提供卡券满减折扣、交易立减等多类即开即用营销活动，亦为商户、ISV、银行等合作方提供营销类API，助力活动方实施个性化营销策略，增强消费者粘性。同时提供统一结算统一对账能力，为活动方提供一站式闭环营销服务。
2.2 目标客户
商户、ISV、银行等具有营销需求的客户。
2.3 角色定义
1）活动发起方：营销活动组织者，负责创建活动、协调组织保障活动正常运行等，外部权益时，活动的创建和交易时权益查询核销都根据这一身份。
2）受理商户：营销活动落地商户，即可以在哪些商户使用权益。
3）出资方：营销活动资金提供方。
2.4 场景示例
用户消费场景，营销产品使用示意图如下：
2.5 产品优势
1）营销活动即开即用，配置流程简单、便捷易用；
2）支持卡券折扣、交易立减等活动形式，满足多种营销场景；
3）支持多方按比例出资、垫资等灵活出资模式；
4）提供详实的营销报表，结算对账清晰高效。
3.总体介绍
3.1 当前支持权益类型
|
权益类型 |
活动模式 |
说明 |
|
优惠券 |
满减券 |
交易金额达到预设值后，可选择单张或多张券进行优惠减免 |
|
交易立减 |
定额/折扣/随机/阶梯 |
定额：交易金额达到预设值后，可享受固定金额的优惠减免 折扣：交易金额达到预设值后，可享受指定折扣减免 随机：支持配置5个减价区间，交易金额达到预设值后，可按权重享受随机减免 阶梯：支持配置15个交易优惠区间，交易金额达到预设值后，可享受减免 |
|
礼品卡 |
礼品卡 |
交易金额＞0.01，且卡余额充足，则可进行多次优惠抵扣 |
3.2 服务入口
目前基础营销提供以下服务入口：
1）运营平台：面向公司内部各分支机构，支持活动管理、数据查询、报表下载等；
2）商服平台：面向出资方服务，支持活动查询、出资管理、数据查询、报表下载等；
3）好老板客户端：面向收单商户管理自有营销活动，当前支持在线创建/发放优惠券，查询活动数据等；
4）API：面向活动发起方，支持活动管理、数据查询等。
3.3 出资方式及资金管理说明
3.3.1 当前支持出资类型
|
出资方式 |
是否垫资 |
说明 |
|
免充值 |
/ |
扣减商户结算金额 |
|
预充值 |
垫资 |
需要运营审核垫资额度后激活活动，营销补贴资金和实付资金到账至商户余额，营销补贴资金在系统单独登记为一笔“补贴登记交易” |
|
不垫资 |
扣减出资方营销账户余额，可核销周期结束后将生成退款单由运营审核后释放营销资金。营销补贴资金和实付资金到账至商户余额，营销补贴资金在系统单独登记为一笔“补贴登记交易” |
3.3.2 出资组合规则
基础营销支持同一活动最多3个出资方联合出资，并对各个出资方分别配置出资方式；其中仅支持一个出资方为预充值出资。
3.3.3 营销账户充值和提现
1）使用预充值（不垫资）模式出资时，需保障出资方营销账户足额时，才能激活对应活动；
2）收银宝商户登录商服平台（https://cus.allinpay.com/）支持营销账户充值（路径：产品中心-营销工具-商户营销），充值和提现时都需要使用系统登记的结算账户。
3.3.4 活动资金调整
当前支持活动资金调整/调减。
3.3.5 活动出资授权
创建活动时支持选择【授权方式】字段，支持运营授权/在线授权两种模式，不填默认运营授权。追加商户/追加出资时，按照活动创建时的【授权方式】处理。
若多商户参与活动，且为免充值出资，则出资方可选取免充值通用出资方“商户出资(8888888888)”。
3.3.5.1.自助授权
支持出资方通过在线签约的形式完成出资授权，活动激活后，系统将根据出资方在系统登记的法人/财务联系人手机号下放签约短信，可根据指引完成出资授权：
1）含免充值出资且出资方式为自助授权时
1>活动受理商户总量不得超过100个，超过时不允许提交，直接拦截。
2>支持配置是否发送授权短信
2）签约链接的获取方式包括：
1>下放到系统登记法人/财务联系人手机号码的签约短信
2>登录商户服务平台签约
3>发起方API获取签约H5（详见下文“5.API接入规范” 4.18 获取授权H5链接）
4>好老板客户端出资授权确认入口（暂未开放）
3.3.5.2.运营授权
针对参与商户众多等不便进行在线签约的情况，系统提供运营平台按批次提交授权资料和进行授权审批的流程。
3.3.5.3.出资/授权方式/活动状态的关联
|
出资方式 |
是否垫资 |
授权说明 |
|
免充值 |
/ |
由受理商户授权，商户授权后该商户支持受理活动，不影响整体活动状态，即纯免充值活动无需审核活动，受理商户完成授权即可使用。支持通过短信链接/API获取的H5完成自助授权和运营平台批量提交授权申请 |
|
预充值 |
垫资 |
需要运营人员在运营平台完成授权 |
|
不垫资 |
需要出资方完成出资授权后活动可正式扣减资金开始运行，支持出资方登录商服平台在线授权和运营平台批量提交授权申请，追加出资时，会生成相应的出资待授权记录 |
3.4 权益归属模式支持
当前支持两种权益归属模式：
- 本地模式：用户是否拥有指定权益、是否可核销成功、核销抵扣金额完全以基础营销为准
- 远端模式：用户是否拥有指定权益、是否可核销成功、核销抵扣金额完全以活动发起方为准
以山东邮政项目为例，远端模式处理时序如下：
3.5 权益核销方式
当前基础营销权益仅支持随收银宝交易核销，核销产品及场景具体如下：
|
当面付 |
标准模式 |
微信 支付宝 分期付 |
本地权益 |
交易立减 优惠券（不支持分期付） 礼品卡（不支持分期付） |
|
订单模式 |
微信 支付宝 快捷支付（笔笔校验） 分期付 |
外部权益（仅交易立减） 本地权益 |
交易立减 优惠券（不支持分期付） 礼品卡（不支持分期付） |
|
|
网上收银 |
/ |
快捷支付 分期付 |
本地权益 |
交易立减 |
|
收银宝 |
/ |
消费 |
本地权益 |
交易立减 |
|
外卡收银 |
/ |
消费 |
本地权益 |
交易立减 |
3.6 通用规则说明
3.6.1 权益叠加规则
- 优惠券、礼品卡、交易立减三种权益类型默认支持叠加使用
- 优惠券、交易立减支持设置同权益类型内的互斥（即不可与其他同类型活动同时使用），如优惠券模板A设置了互斥，则不可和其他优惠券模板一起使用
- 礼品卡不支持多张卡叠加使用，每次只能使用一张
- 优惠券模板支持设置同一次核销可叠加的张数，即单次核销最多可使用几张同样的优惠券
- 可参与随机立减的最大金额=订单金额-优惠券-礼品卡-固定金额/折扣交易立减-0.01。优先使用远端随机权益
- 交易订单抵扣所有权益后，实际支付金额不小于0.01元
- 同一交易远端权益核销状态需保持一致，不支持同一交易部分远端权益核销成功，核销异常将中断交易
- 远端权益核销金额，以远端核销返回为准
- 权益使用门槛，以原始交易金额为准
- 用户侧展示立减，可支持每种来源的立减各4个叠加+4个互斥，如仅包含本地权益，则展示最多8项权益，只包含远端权益同理，如果包含远端+本地，则最多展示16项权益
3.6.2 活动状态说明
|
状态名称 |
状态说明 |
可操作功能 |
|
待提交 |
创建活动，保存成功 |
|
|
待审核 |
活动创建成功或审核不通过时，支持提交审核，待审核人员处理。 特殊说明：纯免充值活动无此状态，提交后直接转换为”投放中“。 |
|
|
审核不通过 |
活动审核不通过，可重新编辑活动并提交 |
|
|
审核通过待授权 |
预充值活动审核通过等待出资方授权 |
|
|
投放中 |
活动正常可用状态 |
|
|
暂停投放 |
手工操作活动暂停，可恢复投放 |
|
|
终止投放 |
手工操作活动终止，或投放时间过期系统定期自动置状态 |
/ |
|
终止核销 |
卡券可用时间过期，或立减投放时间过期 |
/ |
|
完结 |
终止核销满一年且活动余额为零 |
/ |
3.6.3 外部权益使用时的检查逻辑
目前只有交易立减支持外部权益模式，外部权益创建时无需同步优惠规则，以权益方减免规则为准。
- 外部权益模式下匹配权益阶段检查信息：
活动的运营方id必须和匹配条件中的运营方id一致
活动必须运行中状态
活动必须晚于开始时间
活动必须早于结束时间
活动必须在开放时间范围内
活动必须在开放日期范围内
活动必须在开放周中日范围内
活动核销方必须包括当前商户/代理商/门店
活动产品id过滤
活动交易类型过滤
活动支付方式过滤
活动开户银行过滤
活动账户类型过滤
用户id正则匹配
支付账户正则匹配
支付账户cardbin
活动总金额累计量
活动总笔数累计量
活动指定周期总金额累计量
活动指定周期总笔数累计量
核销商户上总金额累计量
核销商户上总笔数累计量
核销商户上指定周期总金额累计量
核销商户上指定周期总笔数累计量
用户上总金额累计量
用户上总笔数累计量
用户上指定周期总金额累计量
用户上指定周期总笔数累计量
支付账户上总金额累计量
支付账户上总笔数累计量
支付账户上指定周期总金额累计量
支付账户上指定周期总笔数累计量
不过滤的维度：
用户白名单 账户白名单
- 核销阶段处理的过滤维度
活动必须运行中状态
活动必须晚于开始时间
活动必须早于结束时间
活动必须在开放时间范围内
活动必须在开放日期范围内
活动必须在开放周中日范围内
活动核销方必须包括当前商户/代理商/门店
活动产品id过滤
活动交易类型过滤
活动支付方式过滤
活动开户银行过滤
活动账户类型过滤
活动Cardbin
活动用户
支付账户
累计量类过滤
活动总金额累计量
活动总笔数累计量
活动指定周期总金额累计量
活动指定周期总笔数累计量
核销商户上总金额累计量
核销商户上总笔数累计量
核销商户上指定周期总金额累计量
核销商户上指定周期总笔数累计量
用户上总金额累计量
用户上总笔数累计量
用户上指定周期总金额累计量
用户上指定周期总笔数累计量
支付账户上总金额累计量
支付账户上总笔数累计量
支付账户上指定周期总金额累计量
支付账户上指定周期总笔数累计量
4.权益类型介绍
4.1优惠券
目前仅支持满减券。
4.1.1 活动参数配置
满减券配置如下：
4.1.1.1 活动基本信息
|
活动参数 |
说明 |
|
活动名称 |
登记活动名称 |
|
规则说明 |
活动规则说明 |
|
活动投放时间 |
|
|
核销模式 |
当前仅支持本地模式 |
|
领取途径 |
支持微信、支付宝客户端领取卡券。 卡券核销方式受领取途径约束，如微信支付仅能对应“微信”领取途径 |
|
活动发起方 |
登记活动发起方 |
|
所属分公司 |
活动发起方所属分公司 |
|
活动banner |
提供默认活动图，可按尺寸750*230、小于2M的标准自行定制 |
|
同活动多券互斥 |
同活动内领取是否互斥（同活动内领A券，是否不能领取B券） |
4.1.1.2 券参数
同一活动，可创建多张券，券信息包含：
|
券参数 |
说明 |
|
券名称 |
优惠券名称 |
|
使用说明 |
优惠券使用说明 |
|
券性质 |
通联券 |
|
券类型 |
目前仅支持满减券 |
|
适用商家类型 |
可用商户/门店 |
|
券面值 |
优惠券面额 |
|
核销方式 |
当面付-微信支付/支付宝支付/快捷支付 |
|
发放规则 |
单用户可领取总量N张；单用户单日可领M张 |
|
生效规则 |
|
|
使用规则 |
|
|
可用时间段 |
|
4.1.1.3 出资预算
|
预算参数 |
说明 |
|
预算维度 |
|
|
预设预算总额 |
按照预算维度，对整个活动设置预算金额，或对每一张券设置预算张数 |
|
单日预算上限 |
按照预算维度，对整个活动设置单日预算金额，或对每一张券设置单日预算张数 |
|
出资授权方式 |
自助授权、运营授权 |
|
追加预算 |
活动激活后，支持按照预算维度，对整个活动追加预算金额，或对每一张券追加预算张数 |
- 按活动配置预算：
- 按券配置预算：
- 追加预算：
4.1.1.4 券可用商户
支持按商户/门店维度批量导入可用商户。目前仅支持导入通联收单商户信息。
4.1.2 发券/领券
- 发券：目前支持活动页面领券、API发券两种发券能力。
- 商户可在自有营销场景中嵌入领券链接或领券二维码，供目标用户领券；
- 有开发能力的商户，可将领券能力和自有场景深度结合，比如向指定用户发券等。
- 领券：
- 用户可通过领券列表/单券页面领取；
- 领取后可查看已有优惠券。
- 当前支持微信/支付宝客户端领券，微信领取后只能在微信核销，同理支付宝领取后在支付宝支付时核销。
4.1.3 商户核券
- 目前支持商户当面付交易时使用满减券；
- 核券后交易撤销，若此时仍在券有效期内，则券回退，仍可再次用券交易；
- 商户核券后，可根据原有交易查询入口查询到交易关联的用券信息，若券含预充值出资情况，会有一笔关联的补贴登记交易。退款时，补贴会根据退款交易金额按比例回退。
4.1.4券失效（作废/过期）
优惠券、礼品卡失效目前有两种情况：
1、 单券超过有效期；
2、 作废处理：
a) 运营平台-优惠券领取明细/礼品卡领取明细：支持批导作废功能，对指定券模板全部作废和批导作废部分券
b) api：支持指定卡id、券id作废
4.2交易立减
目前支持定额立减、折扣立减、随机立减、阶梯立减。
4.2.1 活动参数配置
立减配置如下：
4.2.1.1 活动基本信息
|
活动参数 |
说明 |
|
活动名称 |
登记活动名称 |
|
活动宣传语 |
如“满100元减20元” |
|
活动投放时间 |
|
|
核销模式 |
|
|
活动发起方 |
登记活动发起方 |
|
所属分公司 |
活动发起方所属分公司 |
4.2.1.2 立减参数
|
优惠参数 |
说明 |
|
优惠类型 |
支持定额立减、折扣立减、随机立减 |
|
优惠规则 |
|
|
适用商家类型 |
可用商户/门店 |
|
核销方式 |
|
|
使用规则 |
|
|
可用时间段 |
|
4.2.1.3 出资预算
|
预算参数 |
说明 |
|
预算维度 |
按整个活动预算 |
|
预设预算总额 |
对整个活动设置预算金额 |
|
单日预算上限 |
对整个活动设置单日预算金额 |
|
出资授权方式 |
自助授权、运营授权 |
|
追加预算 |
活动激活后，对整个活动追加预算金额 |
- 按活动配置预算：
- 追加预算：
4.2.1.4 可用商户
支持按商户/门店维度批量导入可用商户。目前仅支持导入通联收单商户信息。
4.2.2 立减优惠使用
- 目前支持商户当面付/网上收银交易时使用立减优惠；
- 撤销含立减活动的交易，若此时仍在活动期内，则活动名额回退，仍可再次参与立减；
- 可根据原有交易查询入口查询到交易关联的立减信息，若含预充值出资情况，会有一笔关联的补贴登记交易。退款时，补贴会根据退款交易金额按比例回退。
4.3礼品卡
4.3.1 活动参数配置
礼品卡配置如下：
4.3.1.1 活动基本信息
|
活动参数 |
说明 |
|
活动名称 |
登记活动名称 |
|
规则说明 |
活动规则说明 |
|
活动投放时间 |
|
|
核销模式 |
当前仅支持本地模式 |
|
领取途径 |
支持微信、支付宝客户端领取卡券。 卡券核销方式受领取途径约束，如微信支付仅能对应“微信”领取途径 |
|
活动发起方 |
登记活动发起方 |
|
所属分公司 |
活动发起方所属分公司 |
4.3.1.2 卡参数
同一活动，可创建多张卡，卡信息包含：
|
券参数 |
说明 |
|
卡名称 |
礼品卡名称 |
|
卡性质 |
通联卡 |
|
卡类型 |
目前仅支持礼品卡 |
|
卡面图片 |
提供默认活动图，可按尺寸696x426px的标准自行定制 |
|
面值类型 |
|
|
适用商家类型 |
可用商户/门店 |
|
使用说明 |
礼品卡使用说明文案 |
|
核销方式 |
当面付-微信支付/支付宝支付/快捷支付 |
|
发放规则 |
单用户可领取总量N张；单用户单日可领M张 |
|
生效规则 |
|
|
可用时间段 |
|
4.3.1.3 出资预算
|
预算参数 |
说明 |
|
预算维度 |
按整个活动预算 |
|
预设预算总额 |
对整个活动设置预算金额 |
|
单日预算上限 |
对整个活动设置单日预算金额 |
|
出资授权方式 |
自助授权、运营授权 |
|
追加预算 |
活动激活后，对整个活动追加预算金额 |
- 按活动配置预算：
- 追加预算：
4.3.1.4 可用商户
支持按商户/门店维度批量导入可用商户。目前仅支持导入通联收单商户信息。
4.3.2 发卡/领卡
- 发卡：目前支持活动页面领卡、API发卡两种发卡能力。
- 商户可在自有营销场景中嵌入领卡链接或领卡二维码，供目标用户领券；
- 有开发能力的商户，可将领卡能力和自有场景深度结合，比如向指定用户发卡等。
- 领卡：
- 用户可通过商户礼品卡页面领取；
- 领取后可查看已有礼品卡。
- 当前支持微信/支付宝客户端领卡，微信领取后只能在微信核销，同理支付宝领取后在支付宝支付时核销。
4.3.3 卡抵扣使用
- 目前支持商户当面付交易时使用礼品卡抵扣消费金额，抵扣后实付金额需大于等于0.01；
- 撤销含礼品卡抵扣的交易，若此时仍在卡有效期内，则卡抵扣金额回退，仍可再次用卡交易；
- 可根据原有交易查询入口查询到交易关联的卡抵扣信息，若含预充值出资情况，会有一笔关联的补贴登记交易。退款时，补贴会根据退款交易金额按比例回退。
4.4 数据查询统计支持
4.4.1 活动明细/统计
1）查询入口和规则：
1>支持运营平台查询与当前登录用户归属匹配的相关活动数据；
2>支持商服平台查询与当前出资方一致的相关活动数据。
2）支持查询优惠领取/核销明细，含领取时间、核销时间、抵用金额、核销商户等关键信息；
3）运营平台支持按照出资方式维度（预充值/免充值）统计出资方周期内活动出资情况、活动核销结束后活动明细导出、指定分公司/活动发起方/出资方活动明细日月报表导出。
4.4.2 权益核销交易查询与通知
1）交易查询：商户核销卡券/立减后，可根据原有基础支付交易查询入口查询到交易关联的优惠抵扣信息；
2）补贴登记：若含预充值出资情况，会有一笔关联的补贴登记交易。退款时，补贴会根据退款交易金额按比例回退；
3）基础支付交易结果通知：包含相应的mktresult，记录使用基础营销权益的情况；
4）基础营销核销通知：以交易为维度，向发起方进行核销通知，如单笔交易中包含多项权益核销，将一并通知。
5.API接入规范
https://isv-test.allinpay.com/project/48/
6.业务申请流程
详询商服事业部张倩。
7.常见问题
略