来自 现金红包 2020-02-29 09:58 的文章

用于后续的服务端接口调用

  为商家的小程序场景提供现金红包发放的一款产品,主要应用于企业、商家给用户发放现金到余额。商家可以配合使用多种红包策略和玩法,如随机金额,指定金额范围等,并且红包还可以分享到支付宝端外使用。

  支付宝开放平台还为开发者提供了现金红包 DEMO,供开发者体验和实现快速接入。

  目前小程序场景下的现金红包功能仅开放 B2C 场景,即商户向个人用户(C端)发放营销红包,用户领取红包到自己的支付宝账户中。

  以上规则中的限额 200 万,由于计算规则与风控策略有关,金额不是完全精确值,仅做参考,请不要依赖此金额做系统处理,应以接口实际返回和查询结果为准,请知晓。

  1.任务制领取红包:用户在小程序内按照指引完成简单的任务,领取相应数额的红包,如下图所示。

  2.关注类领取红包:用户在关注小程序关联的生活号后,可以领取相应数额的现金红包,如下图所示。

  3.积分制领取红包:在符合相关规定的前提下,开发者可以在小程序内建立一定的积分体系,用户可以用积分兑换红包,并在余额中查看,如下图所示。

  4.转发类领取红包:在小程序的营销场景下,开发者可以用红包的形式鼓励用户转发小程序,通过社交裂变提高小程序的访问量,如下图所示。

  5.小程序场景内活跃领取红包:开发者在小程序内可以为满足一定条件的开发者发放红包,如下图所示。

  要在您的小程序内使用现金红包功能,您需要首先完成开发者入驻并创建小程序。

  小程序创建完成后,开发者在功能列表部分可以点击添加功能来给创建的小程序添加功能。

  应用上线完成后,要使用现金红包功能,您还需要完成签约。现金红包功能需要签约才能生效,请点击功能列表右侧签约,提交相关信息;完成签约后,需要一个工作日左右的时间审核(审批结果会以短信和邮件形式告知),待审核完毕后,功能的状态会变成“已生效”,您的应用即可使用现金红包功能。

  “支付宝将来可能会对接口做优化升级,即新增接口返回参数,开发者的系统逻辑需要兼容此类接口升级。

  服务端 SDK 需要商户集成在自己的服务端系统中,用于后续的服务端接口调用。

  在开发者调用接口前,请先了解小程序框架和支付宝开放平台服务端 SDK。开放平台服务端 SDK包含 JAVA、PHP、NodeJS、Python 和五种语言,封装了签名 & 验签、HTTP 接口请求等基础功能。请先下载对应语言版本的 SDK 并引入您的开发工程。

  当前只有在 4.4.2.ALL 及以上版本的JAVA、4.1.0 及以上版本的 PHP 和 4.0.0及以上版本的.Net 的 SDK才支持公钥证书签名方式,其它语言版本需要开发者自行实现签名和验签。使用公钥证书模式的SDK需依赖下述三个JAR包:

  目前小程序端的现金红包功能仅开放 B2C 场景:商户向用户发放营销红包,用户领取红包到自己的支付宝账户中。

  在营销等业务场景下,商户通过调用统一转账接口alipay.fund.trans.uni.transfer直接给用户发放红包(企业账户或者个人账户均可);开发者务必阅读以下接口说明,按照相关要求传入指定参数。

  alipay.fsund.trans.uni.transfer接口的示例代码的具体请求参数和响应参数可参考“关键入参表”和“关键出参表”。

  订单总金额,单位为元,精确到小数点后两位,取值范围[0.01,100000000]

  参与方的标识类型,目前支持如下枚举:1、ALIPAY_USER_ID 支付宝的会员ID

  参与方真实姓名,如果非空,将校验收款支付宝账号姓名一致性。当identity_type=ALIPAY_LOGON_ID时,本字段必填。

  2、payer_show_name,付款方显示名称,可选,收款方在支付宝账单中可见

  查询 B2C 红包转账订单的信息,通过on.query接口,开发者可以查询到商家发出的记录和金额等信息;开发者务必阅读以下接口说明,按照相关要求传入指定参数。

  alipay.fund.trans.common.query接口的示例代码的具体请求参数和响应参数可参考“关键入参表”和“关键出参表”。

  当本参数和商户转账唯一订单号、支付宝支付资金流水号三者同时提供时,将用支付宝支付资金流水号进行查询,忽略其余两者;

  当本参数和支付宝支付资金流水号同时提供时,将用支付宝支付资金流水号进行查询,忽略本参数。

  当本参数和商户转账唯一订单号同时提供时,将用本参数进行查询,忽略商户转账唯一订单号。

  当本参数和支付宝转账单据号、支付宝支付资金流水号同时提供时,将用支付宝支付资金流水号进行查询,忽略本参数;

  当本参数和支付宝转账单据号同时提供时,将用支付宝转账单据号进行查询,忽略本参数;

  当本参数和支付宝转账单据号、商户转账唯一订单号同时提供时,将用本参数进行查询,忽略本参数;

  当本参数和支付宝转账单据号同时提供时,将用本参数进行查询,忽略支付宝转账单据号;

  当本参数和商户转账唯一订单号同时提供时,将用本参数进行查询,忽略商户转账唯一订单号;

  描述特定的业务场景,如果传递了out_biz_no则该字段为必传。本场景固定传DIRECT_TRANSFER

  通过调用alipay.fund.trans.order.changed接口,商户在支付宝单据状态变更后(如现金红包发放成功或者被领取后)触发的通知。

  B2C 现金红包支付宝单据状态变更后触发的通知接口alipay.fund.trans.order.changed。开发者根据自身实际需要,选择合适的通知类型。

  开发者要接收到支付宝的通知,需要配置接收通知的网关地址。在小程序控制台的开发管理页面,选择立即配置来配置服务器,在上方选择开发设置页签,找到应用网关部分,点击设置,如下图所示。具体步骤可以参考详细接入文档。

  以下列表包含小程序接入“现金红包”功能所涉及的所有接口,点击接口英文名可查看接口的公共请求参数,业务请求参数,返回参数,其他语言请求示例以及错误码等。

  支付宝开放平台还为开发者提供了现金红包 DEMO,开发者可以参考快速示例文档进行体验和实现快速接入。

声明:本文图片、文章来源于网络,不代表红包群之意见及观点,如有侵权,请与我联系删除。转载请注明出处: http://www.liuxuetime.com/xianjinhongbao/10792.html