功能场景说明:
商户可以根据自己的营销需求创建现金红包活动,设计大转盘游戏、刮刮卡、成为会员即送现金等丰富多彩的玩法。商户不但可以控制活动预算,还可以控制用户领取次数,领取频率等,让活动设计更贴合商户需求。
用户领取现金红包后,资金将直接进支付宝余额,并在app首页的红包应用中,查看到出资商户的品牌信息。若红包没有被领取完,资金将会在红包失效时(有效时间由商户创建现金红包时指定)退回到商户的支付宝账户中。
产品规则:
1.红包活动发放的现金总金额最小为1.00元;
2.红包发放个数,最小1个,最大10000000个。
一、文档地址
官方文档地址:[url]https://docs.open.alipay.com/282/105997[/url]
二、开发前准备工作
调用步骤:[url]https://openclub.alipay.com/read.php?tid=12194&fid=69[/url]
如何签约以及签约无法成功等相关签约问题:[url]https://openclub.alipay.com/read.php?tid=276&fid=72[/url]
注意事项:1、支持沙箱测试;2、需签约并添加功能;3、支持第三方调用。
检查调用appid的应用功能列表中是否添加“营销活动送红包”并显示已签约。
三、接口集成流程
1、JAVA版请求示例
JAVA版demo:download:营销活动送红包Java版.zip
Java版请求示例:[url]https://openclub.alipay.com/read.php?tid=9920&fid=71[/url]
2、PHP版请求示例
PHP版demo:download:营销活动送红包PHP版.zip
PHP版请求示例:[url]https://openclub.alipay.com/read.php?tid=10350&fid=72[/url]
3、.NET版请求示例
.NET版demo:download:营销活动送红包NET版.zip
.NET版请求示例:[url]https://openclub.alipay.com/read.php?tid=12204&fid=71[/url]
四、注意事项
1、支付流程
将创建现金活动接口返回的支付链接pay_url进行URLdecode处理,然后在浏览器直接访问该url使用卖家账号:
图(1)
图(2)
图(3)
图(4)
2、对账说明
商户创建完成并生效红包活动后,可在支付宝商家红包后台查看发放情况并下载账单(账单将以T+1时效更新)。
商家红包后台地址:[url]https://hb.alipay.com/mhb/giftList.htm[/url]
钱包中可查询红包的账单信息:
红包说明是固定格式:沙箱环境是:沙箱环境-现金红包;正式环境是:公司名称-现金红包
3、退款说明
若红包直到过期后依然没被领取完,那么资金将会在半小时左右退回至支付宝账户。
五、常见问题
1.Q:创建现金活动接口返回“红包内容含有违反法律法规、公序良俗、社会公德以及侵犯第三人合法权益的内容”,如何处理?
A:设置的merchant_link有问题。
2.Q:创建现金活动接口返回“现金红包参数校验失败,活动开始结束时间不合理或活动时间过长”
A:end_time时间格式设置有问题
3.Q:触发现金红包活动接口,触发的红包对应的交易在账单详情内,红包说明对应的值能否修改?
A:不能,账单详情上显示的红包说明是固定格式:沙箱环境是:沙箱环境-现金红包;正式环境是:公司名称-现金红包
4.Q:现金活动列表查询接口中的活动已清算是怎么样的一个场景?
A:超过创建现金活动中设置的end_time活动结束时间以后,现金活动的状态就会变成活动已清算的状态。
5.Q:营销活动送现金红包,单个红包金额限制是多少?
A:每个红包的最大金额不允许超过200.00元,最小金额不允许低于0.2元。
6.Q:随机红包是否有金额范围?
A:红包发放个数,最小1个,最大10000000个。但不同的发放形式(即prize_type)会使得含义不同:
(1)prize_type选择fixed固定金额,每个用户领取的红包金额为total_money除以total_num得到固定金额。
(2)prize_type选择random随机金额,每个用户领取的红包金额为total_money除以total_num得到的
平均金额值的0.5~1.5倍。由于金额是随机的,在红包金额全部被领取完时,有可能total_num有所
剩余、或者大于设置值的情况。
7.Q:营销活动送红包支持哪些发放形式?
A:两种形式:fixed为固定金额,random为随机金额选择随机金额时,单个红包的金额在平均金额
的0.5~1.5倍之间浮动,由于金额是随机的,在红包金额全部被领取完时,有可能total_num有所剩
余、或者大于设置值的情况。
8.Q:pay_url有效期是多久?
A:24个小时
9、Q:营销活动创建活动接口出现“599”?
A:排查方案:[url]https://openclub.alipay.com/read.php?tid=4174&fid=71[/url]