Java集成第三方支付宝(商家劵)——文档篇

简介

商家券是支付宝为商家/服务商（ISV）提供的电子优惠券解决方案。商家/ISV 可在支付宝内通过该能力实现商家优惠券创建、投放、领取、核销的运营闭环，及券活动查询等管理操作。

官方文档

https://opendocs.alipay.com/mini/033rwj

应用场景

在支付成功页发放商家券

• 支持将已创建的商家券活动推广至商家自己的支付宝支付成功页中。通过用户支付后的流量转化，引导二次复购，促进交易额提升。
• 支持支付送或满额送两种玩法：

1. 支付送：用户在成功配置且通过审核的商户使用当面付产品支付成功后即可领取优惠券。
2. 满额送：用户在成功配置且通过审核的商户使用当面付产品支付且订单金额高于特定值时可领取优惠券。
   

接入准备

本文展示了如何从零开始，使用支付宝开放平台服务端 SDK 快速接入 商家券 能力。
商家券 能力支持如下接入方式，商家/ISV 可根据实际业务需要选用：

• 自研商家可通过 自研应用 接入。
• 服务商可通过 代开发（传入 app_auth_token）、代运营 模式代商家接入。详情可查看下文 ISV 代商家接入说明。

创建小程序

登录 支付宝开放平台，创建小程序，详情可查看 创建小程序。
说明：生成的应用唯一标识 APPID 可用于调用开放产品接口。

添加能力

创建小程序后，在 能力管理 中添加 商家券 能力。
说明：

• 自研商家如需通过接口创建支付宝门店，需添加 蚂蚁门店管理 能力。
• 推广商家券可添加 私域营销（推广至商家小程序）、商家营销推广（推广至支付成功页）能力。

开发设置

在 开发设置 中配置应用信息

支付宝网关

必填。开发者调用 OpenAPI 发送 http(s) 请求至支付宝的目标地址（gateway），固定为 https://openapi.alipay.com/gateway.do。

应用网关

必填。用于接收支付宝异步通知消息，需要传入 http(s) 公网可访问网页地址，可查看 应用网关。

开发接入

券码模式

• 上传自定义券码模式
• 发券时指定券码模式

这里以第一种模式为例：

上传自定义券码模式

完成 接入准备 后，商家/服务商（ISV）可根据本文指引快速接入商家券 上传自定义券码 模式。
说明：

• 商家券 能力支持自研商家/ISV 通过 自研、代调用、代运营 模式调用 API 接入，各模式配置详情可查看 接入准备。
• 上传自定义券码模式 创建的商家券活动，支持通过 商家营销推广、私域营销 能力推广至支付成功页、商家小程序等流量场景。
• 商家券 能力 上传自定义券码模式 支持沙箱调试，详情可查看 沙箱调试。

完整接口时序图

API

接口概述

商家劵活动