资金授权解冻接口

开发环境

http://dev-cn.your-api-server.com

POST

/v3/alipay/fund/auth/order/unfreeze

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

错误码

公共错误码

前往查看

业务错误码

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

关联异步通知

触发通知类型

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

触发通知示例

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/fund/auth/order/unfreeze' \
--header 'authorization: ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign' \
--header 'alipay-request-id: $requestid' \
--header 'Content-Type: application/json' \
--data-raw '{
	"notify_url":"http://api.test.alipay.net/atinterface/receive_notify.htm",
	"auth_no":"2016101210002001810258115912",
	"out_request_no":"2016101200104001110081001",
	"amount":20.11,
	"remark":"2014-05期解冻200.00元",
	"extra_param":"{\"unfreezeBizInfo\": \"{\\\"bizComplete\\\":\\\"true\\\"}\"}"
}'

响应示例

{
	"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
}

请求参数

Header 参数

authorization

string

必需

示例值:

ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign

alipay-request-id

string

必需

示例值:

$requestid

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

notify_url

string

可选

支付宝服务器主动通知商户服务器里指定的页面http/https路径。在body参数中传递

auth_no

string

必需

支付宝资金授权订单号。

out_request_no

string

必需

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

amount

number

必需

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

remark

string

必需

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

extra_param

string

可选

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

示例

返回响应

🟢200成功

application/json

Body

auth_no

string

必需

支付宝资金授权订单号

out_order_no

string

可选

商户的授权资金订单号

operation_id

string

必需

支付宝资金操作流水号

out_request_no

string

必需

商户本次资金操作的请求流水号

amount

number

必需

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

status

string

必需

资金操作流水的状态目前支持：SUCCESS：成功

gmt_trans

string

可选

授权资金解冻成功时间，格式：YYYY-MM-DD HH:MM:SS

credit_amount

number

可选

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

fund_amount

number

可选

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

修改于 2023-11-23 02:48:25

线上资金授权冻结接口

资金授权操作查询接口

资金授权解冻接口

错误码#

公共错误码#

业务错误码#

关联异步通知#

触发通知类型#

触发通知示例#

请求参数

返回响应

错误码

公共错误码

业务错误码

关联异步通知

触发通知类型

触发通知示例