AI 助理
文档备案控制台
开发者社区 支付宝开发者社区 文章 正文

收发现金红包——alipay.fund.coupon.order.disburse(红包打款接口)

2019-04-25 1268
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 接口名称：红包打款接口英文名称：alipay.fund.coupon.order.disburse产品首页：[url]https://openclub.alipay.com/read.php?tid=12180&fid=72[/url]上一步：[url]https://openclub.alipay.com/read.php?tid=13602&fid=72[/url]下一步：[url]https://openclub.alipay.com/read.php?tid=13610&fid=72[/url]一、注意事项1、用户领取红包，通过打款接口实现。

接口名称：红包打款接口

英文名称：alipay.fund.coupon.order.disburse

产品首页：[url]https://openclub.alipay.com/read.php?tid=12180&fid=72[/url]

上一步：[url]https://openclub.alipay.com/read.php?tid=13602&fid=72[/url]

下一步：[url]https://openclub.alipay.com/read.php?tid=13610&fid=72[/url]

一、注意事项

1、用户领取红包，通过打款接口实现。

2、若是想实现拆分红包用户分别领取（领取红包A+领取红包B+……+领取红包n<=总红包）。

3、打款接口调用频次：每秒要小于100次；

4、打款接口的发送的异步通知是通过红包打款接口设置的notify_url地址进行接收；

5、使用调用逻辑中，假设支付接口选择红包页面支付接口，且参数设置out_order_no为2017122716463224，out_request_no为201712271645328，其他参数一致。

二、参数说明

1、out_order_no: 商户的授权资金订单号，同一商户不同的订单，不可重复，保持唯一性；

注：打款接口的out_order_no与支付接口的out_order_no不可重复，保持唯一性。

2、out_request_no：商户本次资金操作的请求流水号，同一商户每次不同的资金操作请求，商户请求流水号不要重复；

注：out_order_no不相同的情况下，out_request_no参数值相同可调用成功，建议记录out_order_no参数为准。

3、deduct_auth_no与deduct_out_order_no不能同时为空：

deduct_auth_no:：发放红包时产生的支付宝资金订单号（支付接口返回的auth_no）；

deduct_out_order_no：发放红包时的商户授权资金订单号（支付接口设置的out_order_no）；

4、payee_user_id：收款方支付宝唯一用户号——pid（根据设置的pid，红包金额转入对应账户内）；

三、接口请求示例

JAVA版请求示例

1、A用户领取红包

public static void main(String[] args) throws AlipayApiException {
        //在SDK调用前需要进行初始化
		AlipayClient alipayClient = new DefaultAlipayClient(AlipayConfig.gatewayUrl, AlipayConfig.app_id, AlipayConfig.merchant_private_key, AlipayConfig.format, AlipayConfig.charset, AlipayConfig.alipay_public_key, AlipayConfig.sign_type);
		AlipayFundCouponOrderDisburseRequest request = new AlipayFundCouponOrderDisburseRequest();
		AlipayFundCouponOrderDisburseModel model = new AlipayFundCouponOrderDisburseModel();
        //商户的授权资金订单号,同一商户不同的订单，商户授权资金订单号不能重复
		model.setOutOrderNo("20171228925");
		//本次资金操作的请求流水号,同一商户每次不同的资金操作请求
		model.setOutRequestNo("201712271645335");
        //发放红包时产生的支付宝资金订单号。deduct_auth_no与下面的deduct_out_order_no不能同时为空
        //二者都存在时，以deduct_auth_no为准
        //model.setDeductAuthNo("");
		//该参数为支付接口的OutOrderNo与OutOrderNo
        model.setDeductOutOrderNo("2017122716463224");
        model.setOrderTitle("红包打款");
        model.setAmount("0.01");
        //收款方的支付宝唯一用户号
        model.setPayeeUserId("用户2088开头的信息（此处脱敏）");
        //收款方的支付宝登录号，形式为手机号或邮箱等
       // model.setPayeeLogonId("手机号");
        //该笔订单允许的最晚付款时间，逾期将关闭该笔订单 .取值范围：1m～7d
        model.setPayTimeout("1h");
        request.setBizModel(model);
		AlipayFundCouponOrderDisburseResponse response = alipayClient.execute(request);
		if(response.isSuccess()){
		System.out.println("调用成功");
		} else {
		System.out.println("调用失败");
		}
		System.out.println(response.getBody());
}

2、B用户领取红包

当第二个人领取红包时，参数注意如下：

1、out_order_no：（需改变）为同一商户不同订单的授权资金订单号；

2、out_request_no：为本次交易，资金操作的请求流水号，是否重复都可以调用成功（但建议不要重复）；

若out_order_no未改变时，报错UNIQUE_VIOLATION：下单失败，商户订单号重复。

public static void main(String[] args) throws AlipayApiException {
        //在SDK调用前需要进行初始化
		AlipayClient alipayClient = new DefaultAlipayClient(AlipayConfig.gatewayUrl, AlipayConfig.app_id, AlipayConfig.merchant_private_key, AlipayConfig.format, AlipayConfig.charset, AlipayConfig.alipay_public_key, AlipayConfig.sign_type);
		AlipayFundCouponOrderDisburseRequest request = new AlipayFundCouponOrderDisburseRequest();
		AlipayFundCouponOrderDisburseModel model = new AlipayFundCouponOrderDisburseModel();
        //商户的授权资金订单号,同一商户不同的订单，商户授权资金订单号不能重复
		model.setOutOrderNo("20171228926");
		//本次资金操作的请求流水号,同一商户每次不同的资金操作请求
		model.setOutRequestNo("201712271645335");
        //发放红包时产生的支付宝资金订单号。deduct_auth_no与下面的deduct_out_order_no不能同时为空
        //二者都存在时，以deduct_auth_no为准
        //model.setDeductAuthNo("");
		//该参数为支付接口的OutOrderNo与OutOrderNo
        model.setDeductOutOrderNo("2017122716463224");
        model.setOrderTitle("红包打款给用户B");
        model.setAmount("0.01");
        //收款方的支付宝唯一用户号
        model.setPayeeUserId("用户2088开头的信息（此处脱敏）");
        //收款方的支付宝登录号，形式为手机号或邮箱等
       // model.setPayeeLogonId("手机号");
        //该笔订单允许的最晚付款时间，逾期将关闭该笔订单 .取值范围：1m～7d
        model.setPayTimeout("1h");
        request.setBizModel(model);
		AlipayFundCouponOrderDisburseResponse response = alipayClient.execute(request);
		if(response.isSuccess()){
		System.out.println("调用成功");
		} else {
		System.out.println("调用失败");
		}
		System.out.println(response.getBody());
}


PHP版请求示例

1、A用户领取红包

<?php
require_once 'AopSdk.php';
$aop = new AopClient ();
$aop->appId = '填写您的appid';
$aop->rsaPrivateKey = '填写您的私钥';
$aop->alipayrsaPublicKey='填写您的支付宝公钥';
$aop->gatewayUrl = 'https://openapi.alipay.com/gateway.do';
$aop->apiVersion = '1.0';
$aop->signType = 'RSA2';
$aop->postCharset='utf-8';
$aop->format='json';
$date=date("YmdHis");
$arr=range(1000,9999);
shuffle($arr);
$request = new AlipayFundCouponOrderDisburseRequest ();
$request->setBizContent("{" .
			""out_order_no":"20171228925"," .
// 			""deduct_auth_no":"2014031600002001260000001024"," .
			""deduct_out_order_no":"2017122716463224"," .
			""out_request_no":"201712271645335"," .
			""order_title":"红包打款"," .
			""amount":0.01," .
			""payee_user_id":"用户2088开头的信息（此处脱敏）"," .
// 			""payee_logon_id":"收款方登录号"," .
			""pay_timeout":"1h"" .
			"}");
$result = $aop->execute ( $request); 
var_dump($result);

2、B用户领取红包

当第二个人领取红包时，参数注意如下：

1、out_order_no：（需改变）为同一商户不同订单的授权资金订单号；

2、out_request_no：为本次交易，资金操作的请求流水号，是否重复都可以调用成功（但建议不要重复）；

若out_order_no未改变时，报错UNIQUE_VIOLATION：下单失败，商户订单号重复。

<?php
require_once 'AopSdk.php';
$aop = new AopClient ();
$aop->appId = '填写您的appid';
$aop->rsaPrivateKey = '填写您的私钥';
$aop->alipayrsaPublicKey='填写您的支付宝公钥';
$aop->gatewayUrl = 'https://openapi.alipay.com/gateway.do';
$aop->apiVersion = '1.0';
$aop->signType = 'RSA2';
$aop->postCharset='utf-8';
$aop->format='json';
$date=date("YmdHis");
$arr=range(1000,9999);
shuffle($arr);
$request = new AlipayFundCouponOrderDisburseRequest ();
$request->setBizContent("{" .
			""out_order_no":"20171228926"," .
// 			""deduct_auth_no":"2014031600002001260000001024"," .
			""deduct_out_order_no":"2017122716463224"," .
			""out_request_no":"201712271645335"," .
			""order_title":"红包打款给用户B"," .
			""amount":0.01," .
			""payee_user_id":"用户2088开头的信息（此处脱敏）"," .
// 			""payee_logon_id":"收款方登录号"," .
			""pay_timeout":"1h"" .
			"}");
$result = $aop->execute ( $request); 
var_dump($result);


.NET版本请求示例

IAopClient client = new DefaultAopClient(config.gatewayUrl, config.app_id, config.private_key, "json", "1.0", "RSA2", config.alipay_public_key, config.charset, false);


        AlipayFundCouponOrderDisburseRequest request = new AlipayFundCouponOrderDisburseRequest();
        request.BizContent="{" +
        ""out_order_no":"20171228925"," +
// 			""deduct_auth_no":"2014031600002001260000001024"," +
			""deduct_out_order_no":"2017122716463224"," +
			""out_request_no":"201712271645335"," +
			""order_title
文章标签：
PHP
数据格式
JSON
扬朋
目录
相关文章
angry_bugs
|
固态存储 NoSQL Go
使用 cProfile 和火焰图调优 Python 程序性能(下)
使用 cProfile 和火焰图调优 Python 程序性能
angry_bugs
579 0
angry_bugs
|
JSON 监控 JavaScript
使用 cProfile 和火焰图调优 Python 程序性能(上)
使用 cProfile 和火焰图调优 Python 程序性能
angry_bugs
427 0
AI侠客
|
6月前
|
人工智能 运维 安全
2025国内低代码开发平台大盘点
低代码平台正成为企业数字化转型的关键工具，凭借可视化开发、AI融合与高效协作等趋势，助力企业快速构建应用。然而，灵活性受限、平台依赖与安全风险仍是发展中的挑战。本文深入解析低代码发展趋势、常见问题及十大平台评测，为企业选型提供权威参考。
AI侠客
674 1
阿里云开发者
|
缓存 自然语言处理 算法
大模型意图识别工程化实践
本文重点介绍大模型意图识别能力在智能电视核心链路中的落地过程和思考，对比了基础模型、RAG 、以及7b模型微调三种方案的优缺点。
阿里云开发者
5167 122
weixin_836869520
|
监控 Java
Java中的内存泄漏分析与排查技巧
Java中的内存泄漏分析与排查技巧
weixin_836869520
255 3
蚝油菜花
|
12月前
|
人工智能 算法 数据格式
DeepSeek 开源周第二弹！DeepEP：专为 MoE 训练和推理设计的并行通信库
DeepEP 是 DeepSeek 开源的首个专为混合专家模型（MoE）训练和推理设计的通信库，支持高吞吐量、低延迟通信，优化 NVLink 和 RDMA 网络性能。
蚝油菜花
1310 3
Harry技术
五、ArkTS 常用组件-文本显示 (Text / Span)
本文档介绍了ArkTS中的文本显示组件（Text/Span），包括其基本概念、参数设置、常用属性（如字体大小、粗细、颜色、对齐方式）、最大行数及超长处理方法，以及子组件Span的使用方法。Text组件支持多种参数类型，包括字符串、资源引用等，并提供了丰富的属性设置选项以满足不同的文本显示需求。Span组件则主要用于在Text组件内部实现更精细的文本格式化，如设置不同的字体颜色、大小、装饰线等，同时支持点击事件的添加。
Harry技术
1016 2
祈澈菇凉
|
JavaScript 开发工具 git
使用webstorm来创建并且运行vue项目详细教程
使用webstorm来创建并且运行vue项目详细教程
祈澈菇凉
1827 0
游客j4mujezz7vm7y
|
JSON 安全 数据格式
7-6|python报错TypeError: can't pickle _thread.RLock objects
7-6|python报错TypeError: can't pickle _thread.RLock objects
游客j4mujezz7vm7y
714 0

支付宝开发者社区

热门文章

最新文章

  • 1
    阿里云CentOS 7上安装配置Docker
  • 2
    用51单片机做一个物联网温度计+远程开关
  • 3
    如何优化Python读取大文件的内存占用与性能
  • 4
    CV：利用cv2自带两步法haarcascade_frontalface_default.xml、_smile.xml实现对人脸、笑脸同时检测
  • 5
    AR网页小广告来了，Blippar可免费提供技术支持
  • 6
    binary search of an integer array
  • 7
    栈与递归的实现
  • 8
    唐寅 《桃花庵歌》
  • 9
    ArcSDE常见问题
  • 10
    解决jsp开发中不支持EL问题
  • 1
    2026年阿里云3步部署OpenClaw/Clawdbot+必装Skill+实战案例全攻略
    223
  • 2
    别再用ChatGPT群发祝福了！30分钟微调一个懂你关系的“人情味”拜年AI
    96
  • 3
    还不会部署OpenClaw？阿里云推出五种OpenClaw快速部署方案
    88
  • 4
    OpenClaw（Clawdbot）一键部署，打造滴滴出行助手，一键打车+实时查司机位置全攻略
    74
  • 5
    告别Demo｜手把手教你构建可用的LangChain测试智能体
    81
  • 6
    OpenClaw（Clawdbot）汉化版完整搭建指南 全平台安装+附阿里云上部署教程
    228
  • 7
    GLM-5深夜官宣：Pony Alpha身份揭晓，编程能力逼近Claude Opus
    195
  • 8
    OpenClaw（Clawdbot）阿里云零基础部署，打造QQ社群智能助手，自动化运营全攻略
    67
  • 9
    32B大模型塞进消费级显卡？我用“人情味”做了场春节实验
    55
  • 10
    Seedance 2.0 出现后，AI 视频首次暴露出“工程级异常”
    71

    • 相关电子书

    更多
  • 低代码开发师（初级）实战教程
  • 冬季实战营第三期：MySQL数据库进阶实战
  • 阿里巴巴DevOps 最佳实践手册
    • 下一篇
    第五届伏魔挑战赛如约来袭，诚邀各路高手来战！