资金授权解冻接口 -凯发app官方网站

支持第三方代理调用

更新时间：2023-09-25 15:48:34

订阅更新

我的文档

设置

接入检测（

即可查看检测结果）

若有未通过的接入检测项，接口将无法调通

通用场景

当资金授权发生之后一段时间内，由于买家或者商家等其他原因需要要解冻资金，商家可通过资金授权解冻接口将授权资金进行解冻，支付宝将在收到解冻请求并验证成功后，按解冻规则将冻结资金按原路进行解冻

公共请求参数

参数	类型	是否必选	最大长度	描述	示例值
app_id	string	必选	32	支付宝分配给开发者的应用id	2014072300007148
method	string	必选	128	接口名称	alipay.fund.auth.order.unfreeze
format	string	可选	40	仅支持json	json
charset	string	必选	10	请求使用的编码格式，如utf-8,gbk,gb2312等	utf-8
sign_type	string	必选	10	商户生成签名字符串所使用的签名算法类型，目前支持rsa2和rsa，推荐使用rsa2	rsa2
sign	string	必选	344	商户请求参数的签名串，详见签名	详见示例
timestamp	string	必选	19	发送请求的时间，格式"yyyy-mm-dd hh:mm:ss"	2014-07-24 03:07:50
version	string	必选	3	调用的接口版本，固定为：1.0	1.0
notify_url	string	可选	256	支付宝服务器主动通知商户服务器里指定的页面http/https路径。	http://api.test.alipay.net/atinterface/receive_notify.htm
app_auth_token	string	可选	40	详见应用授权概述
biz_content	string	必选		请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

业务请求参数

auth_no必选string(64)

【描述】支付宝资金授权订单号。

【示例值】2016101210002001810258115912

out_request_no必选string(64)

【描述】解冻请求流水号。
如果是针对同一笔授权单不同的解冻请求，如第一次解冻1元，第二次解冻2元，则解冻请求流水号必须不重复；
如果是针对同一笔解冻请求的多次发起，则需要保证每次发起，解冻请求流水号和解冻金额都相同

【示例值】2016101200104001110081001

amount必选price(11)

【描述】本次操作解冻的金额，单位为：元（人民币），精确到小数点后两位。
取值范围：[0.01,100000000.00]

【示例值】20.11

remark必选string(100)

【描述】商户对本次解冻操作的附言描述

【示例值】2014-05期解冻200.00元

extra_param可选string(2048)

【描述】解冻扩展信息。map的json格式，目前支持如下key：
unfreezebizinfo：由芝麻消费，当前支持value如下：
"bizcomplete":"true"——标识本次解冻用户已履约，true表示信用单履约完结

【示例值】{"unfreezebizinfo": "{\"bizcomplete\":\"true\"}"}

参数	类型	是否必选	最大长度	描述	示例值
auth_no	string	必选	64	支付宝资金授权订单号。	2016101210002001810258115912
out_request_no	string	必选	64	解冻请求流水号。如果是针对同一笔授权单不同的解冻请求，如第一次解冻1元，第二次解冻2元，则解冻请求流水号必须不重复；如果是针对同一笔解冻请求的多次发起，则需要保证每次发起，解冻请求流水号和解冻金额都相同	2016101200104001110081001
amount	price	必选	11	本次操作解冻的金额，单位为：元（人民币），精确到小数点后两位。取值范围：[0.01,100000000.00]	20.11
remark	string	必选	100	商户对本次解冻操作的附言描述	2014-05期解冻200.00元
extra_param	string	可选	2048	解冻扩展信息。map的json格式，目前支持如下key： unfreezebizinfo：由芝麻消费，当前支持value如下： "bizcomplete":"true"——标识本次解冻用户已履约，true表示信用单履约完结	{"unfreezebizinfo": "{\"bizcomplete\":\"true\"}"}

常见请求示例

默认示例

javac#phphttp

alipayclient alipayclient = new defaultalipayclient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","gbk","alipay_public_key","rsa2");
alipayfundauthorderunfreezerequest request = new alipayfundauthorderunfreezerequest();
jsonobject bizcontent = new jsonobject();
bizcontent.put("auth_no","2021081710002001640564315836");
bizcontent.put("out_request_no","outrequestno123");
bizcontent.put("amount",0.01);
bizcontent.put("remark","解冻资金");
jsonobject extraparam = new jsonobject();
jsonobject unfreezebizinfo = new jsonobject();
unfreezebizinfo.put("bizcomplete",true);
extraparam.put("unfreezebizinfo",unfreezebizinfo);
bizcontent.put("extra_param",extraparam);
// 设置整体请求参数
request.setbizcontent(bizcontent.tostring());
// 使用execute方法发起请求
alipayfundauthorderunfreezeresponse response = alipayclient.execute(request);
if(response.issuccess()){
system.out.println("调用成功");
} else {
system.out.println("调用失败");
}

说明：本示例仅供参考。

公共响应参数

参数	类型	是否必选	最大长度	描述	示例值
code	string	必选	-	网关返回码,	40004
msg	string	必选	-	网关返回码描述,	business failed
sub_code	string	可选	-	业务返回码，参见具体的api接口文档	acq.trade_has_success
sub_msg	string	可选	-	业务返回码描述，参见具体的api接口文档	交易已被支付
sign	string	必选	-	签名,	dzxh8eetuahoye3w1j poiphfdxoybfunn1lket/v7p4zjdyojwea6izs6hz0ydw5cp/viufub5i0/v5wens3oyr8zredqo6d futdlhdc efyckiqhbxizgngpdpdfp1pis7bdhhzrszhbrqb7o4k3dxc aanfauu4v6zdwczo=

业务响应参数

auth_no必选string(64)

【描述】支付宝资金授权订单号

【示例值】2014070800002001550000014417

operation_id必选string(64)

【描述】支付宝资金操作流水号

【示例值】2014070800032850551

out_request_no必选string(64)

【描述】商户本次资金操作的请求流水号

【示例值】20140707001555633

amount必选price(11)

【描述】本次操作解冻的金额，单位为：元（人民币），精确到小数点后两位，取值范围：[0.01,100000000.00]

【示例值】20.81

status必选string(10)

【描述】资金操作流水的状态
目前支持：success：成功

【示例值】success

out_order_no特殊可选string(64)

【描述】商户的授权资金订单号

【示例值】4977164666634053

gmt_trans特殊可选date(32)

【描述】授权资金解冻成功时间，格式：yyyy-mm-dd hh:mm:ss

【示例值】2014-09-15 11:23:04

credit_amount特殊可选price(11)

【描述】本次解冻操作中信用解冻金额，单位为：元（人民币），精确到小数点后两位

【示例值】0.01

fund_amount特殊可选price(11)

【描述】本次解冻操作中自有资金解冻金额，单位为：元（人民币），精确到小数点后两位

【示例值】0.01

参数	类型	是否必选	最大长度	描述	示例值
auth_no	string	必选	64	支付宝资金授权订单号	2014070800002001550000014417
out_order_no	string	特殊可选	64	商户的授权资金订单号	4977164666634053
operation_id	string	必选	64	支付宝资金操作流水号	2014070800032850551
out_request_no	string	必选	64	商户本次资金操作的请求流水号	20140707001555633
amount	price	必选	11	本次操作解冻的金额，单位为：元（人民币），精确到小数点后两位，取值范围：[0.01,100000000.00]	20.81
status	string	必选	10	资金操作流水的状态目前支持：success：成功	success
gmt_trans	date	特殊可选	32	授权资金解冻成功时间，格式：yyyy-mm-dd hh:mm:ss	2014-09-15 11:23:04
credit_amount	price	特殊可选	11	本次解冻操作中信用解冻金额，单位为：元（人民币），精确到小数点后两位	0.01
fund_amount	price	特殊可选	11	本次解冻操作中自有资金解冻金额，单位为：元（人民币），精确到小数点后两位	0.01

响应示例

正常示例

异常示例

{
    "alipay_fund_auth_order_unfreeze_response": {
        "code": "10000",
        "msg": "success",
        "auth_no": "2014070800002001550000014417",
        "out_order_no": "4977164666634053",
        "operation_id": "2014070800032850551",
        "out_request_no": "20140707001555633",
        "amount": 20.81,
        "status": "success",
        "gmt_trans": "2014-09-15 11:23:04",
        "credit_amount": 0.01,
        "fund_amount": 0.01
    },
    "sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}

说明：本示例仅供参考。

公共错误码

业务错误码

错误码	错误描述	凯发app官方网站的解决方案
illegal_argument	参数异常或参数缺失	请求参数有错，重新检查请求后，再重启发起资金解冻操作
unique_violation	解冻信息被篡改	更换商户请求流水号后，重新发起请求
system_error	系统错误	请使用相同的参数再次调用
payer_user_status_limit	付款方状态受限	买家支付宝账户受限，请登录支付宝认证升级，详情咨询 4007585858
auth_order_not_exist	授权订单不存在	本笔授权订单不存在，确认请求资金解冻的资金授权订单号是否正确
request_amount_exceed	请求解冻金额超限	更改解冻金额，重新发起请求
illegal_status	订单状态非法	查询该笔授权操作信息，确认用户资金授权冻结成功
order_already_finish	授权订单已经完结，无法再进行资金操作	本笔授权订单已经完结，不允许进行资金解冻操作，确认请求资金解冻的资金授权订单号是否正确
order_already_closed	授权订单已经关闭，无法再进行资金操作	本笔授权订单已经关闭，不允许进行资金解冻操作，确认请求资金解冻的资金授权订单号是否正确，该笔授权订单号是否已经发起过解冻
payer_not_exist	买家不存在	买家信息不存在，请联系支付宝小二确认买家是否销户。
biz_error	业务异常，	商户自行确认该笔预授权订单是否被用于其他业务，或者联系支付宝客服
access_forbidden	授权失败，本商户没有权限使用该产品，建议顾客使用其他方式付款	未签约合同或者合同已到期

触发通知类型

通知类型	描述	默认开启
fund_auth_unfreeze	资金授权订单解冻通知	1

触发通知示例

https://www.merchant.com/receive_notify.htm?notify_type=trade_status_sync¬ify_id=91722adff935e8cfa58b3aabf4dead6ibe¬ify_time=2017-02-16 21:46:15&sign_type=rsa2&sign=wco t3d8kg71dtlkwn7r9pzuoxeabjwp8/fousxcuskxsovyxbpsaidpryscjhcjmaglncjokjqlj28/asl93jotw39fx6i07lxhnbpknezalwmvpdnqui01hzszf9v1i6ggzjbiad5lg8bzttxzoj87ub2i9guj3nr/nuc9vey=&total_freeze_amount=null&total_unfreeze_amount=null&total_pay_amount=null&rest_amount=null&auth_no=null&out_order_no=null&operation_id=null&out_request_no=null&operation_type=null&amount=null&status=null&gmt_create=null&gmt_trans=null&payer_logon_id=null&payer_user_id=null&credit_amount=0.01&fund_amount=0.01&total_freeze_credit_amount=0.01&total_freeze_fund_amount=0.01&total_unfreeze_credit_amount=0.01&total_unfreeze_fund_amount=0.01&total_pay_credit_amount=0.01&total_pay_fund_amount=0.01&rest_credit_amount=0.01&rest_fund_amount=0.01&enterprise_pay_info={"biz_info":"{\"enterprisepayamount\":\"0.01\"}"}