开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
文档中心
网页&移动应用 
预授权支付
权限集列表
预授权支付(必选)
接入指南
api 列表
预授权
交易
账单
相关资料
商家分账(可选)
 >  >  >  >  > 资金授权操作查询接口

资金授权操作查询接口 -凯发app官方网站

收藏
订阅更新
我的文档
设置
接入检测
即可查看检测结果)
若有未通过的接入检测项,接口将无法调通
通过该接口可以查询单笔明细的详细信息

公共请求参数

参数类型是否必选最大长度描述示例值
app_idstring必选32
支付宝分配给开发者的应用id
2014072300007148
methodstring必选128
接口名称
alipay.fund.auth.operation.detail.query
formatstring可选40
仅支持json
json
charsetstring必选10
请求使用的编码格式,如utf-8,gbk,gb2312等
utf-8
sign_typestring必选10
商户生成签名字符串所使用的签名算法类型,目前支持rsa2和rsa,推荐使用rsa2
rsa2
signstring必选344
商户请求参数的签名串,详见签名
详见示例
timestampstring必选19
发送请求的时间,格式"yyyy-mm-dd hh:mm:ss"
2014-07-24 03:07:50
versionstring必选3
调用的接口版本,固定为:1.0
1.0
app_auth_tokenstring可选40
biz_contentstring必选
请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档

业务请求参数

auth_no特殊可选string(64)
【描述】支付宝授权资金订单号。 与商户的授权资金订单号不能同时为空,二者都传入时,以支付宝资金授权订单号为准,该参数与支付宝授权资金操作流水号配对使用。
【示例值】2014021601002000640012345678
out_order_no特殊可选string(64)
【描述】商户的授权资金订单号。 与支付宝的授权资金订单号不能同时为空,二者都传入时,以支付宝的授权资金订单号为准,该参数与商户的授权资金操作流水号配对使用。 该值与资金冻结时 out_order_no一致。
【示例值】8077735255938023
operation_id特殊可选string(64)
【描述】支付宝的授权资金操作流水号。 与商户的授权资金操作流水号不能同时为空,二者都传入时,以支付宝的授权资金操作流水号为准,该参数与支付宝授权资金订单号配对使用。
【示例值】20140216010020006400
out_request_no特殊可选string(64)
【描述】商户的授权资金操作流水号。 与支付宝的授权资金操作流水号不能同时为空,二者都传入时,以支付宝的授权资金操作流水号为准,该参数与商户的授权资金订单号配对使用。 查询冻结明细时,该值与发起冻结操作时传入的out_request_no一致; 查询解冻明细时,该值与发起解冻操作时传入的out_request_no一致; 查询支付明细时,该值与发起转支付操作时传入的out_trade_no一致。
【示例值】20140216001001
operation_type可选string(64)
【描述】需要查询的授权资金操作类型。 未传入本参数时,如果仅查询出单笔明细则直接返回,如果查询出多笔则优先返回冻结明细、无冻结明细时返回解冻明细; 当传入本参数时,则严格按照该操作类型返回对应明细
【枚举值】
冻结: freeze
解冻: unfreeze
支付: pay
【示例值】freeze
常见请求示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.fund.auth.operation.detail.query&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
 -f 'biz_content={
	"operation_type":"freeze",
	"out_order_no":"8077735255938023",
	"operation_id":"20140216010020006400",
	"out_request_no":"20140216001001",
	"auth_no":"2014021601002000640012345678"
}' 
说明:本示例仅供参考。

公共响应参数

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

业务响应参数

auth_no必选string(64)
【描述】支付宝资金授权订单号
【示例值】2014031600002001260000001000
out_order_no必选string(64)
【描述】商户的授权资金订单号
【示例值】20140216001
order_status必选string(20)
【描述】授权单状态:init(初始状态:已创建未授权)、authorized(已授权状态:授权成功,可以进行转支付或解冻操作)、finish(完成状态:转支付完成且无剩余冻结资金)、closed(关闭状态:授权未完成超时关闭或冻结资金全额解冻)
【示例值】authorized
total_freeze_amount必选price(11)
【描述】订单累计的冻结金额,单位为:元(人民币)
【示例值】4800.00
rest_amount必选price(11)
【描述】订单当前剩余冻结金额,单位为:元(人民币)。
【示例值】4600.00
total_pay_amount必选price(11)
【描述】订单累计用于支付的金额,单位为:元(人民币)
【示例值】0.00
order_title必选string(100)
【描述】业务订单的简单描述,如商品名称等
【示例值】0元购土豪金
operation_id必选string(64)
【描述】支付宝资金操作流水号
【示例值】20140216355864862002
out_request_no必选string(64)
【描述】商户资金操作的请求流水号
【示例值】20140216001001
amount必选price(11)
【描述】该笔资金操作流水operation_id对应的操作金额,单位为:元(人民币)
【示例值】200.00
operation_type必选string(20)
【描述】支付宝资金操作类型,表示当前查询到的这笔明细的操作类型。
【枚举值】
冻结: freeze
解冻: unfreeze
支付: pay
【示例值】unfreeze
status必选string(20)
【描述】资金操作流水的状态, 目前支持: init:初始 success:成功 closed:关闭
【示例值】success
remark必选string(100)
【描述】商户对本次操作的附言描述,长度不超过100个字母或50个汉字
【示例值】2014-05期解冻200.00元
gmt_create必选date(20)
【描述】资金授权单据操作流水创建时间, 格式:yyyy-mm-dd hh:mm:ss
【示例值】2014-01-01 20:00:00
以下参数 可选 
payer_user_idstring(32)
【描述】付款方支付宝账号对应的支付宝唯一用户号,以2088开头的16位纯数字组成
新商户建议使用payer_open_id替代该字段。对于新商户,payer_user_id字段未来计划逐步回收,存量商户可继续使用。如使用payer_open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看openid配置申请
【示例值】2088402019148643
payer_open_idstring(128)
【描述】支付宝openid,用户(userid)在应用(appid)下的唯一标识。  详情可查看 openid简介
【示例值】03914imefxss9k-tsvhy-iisrllofthfgdvo-hu30xtkpg9
extra_param特殊可选string(300)
【描述】商户请求创建预授权订单时传入的扩展参数,仅返回商户自定义的扩展信息(merchantext)
【示例值】{"merchantext":"key1=value1,key2=value2"}
pre_auth_type特殊可选string(20)
【描述】预授权类型,信用预授权情况下值为 credit_auth,表示该笔预授权为信用预授权,实际没有冻结用户资金;其它情况均不返回该字段。
【枚举值】
信用预授权: credit_auth
【示例值】credit_auth
trans_currency特殊可选string(8)
【描述】标价币种, amount 对应的币种单位。支持澳元:aud, 新西兰元:nzd, 台币:twd, 美元:usd, 欧元:eur, 英镑:gbp
【示例值】usd
total_freeze_credit_amount特殊可选price(11)
【描述】累计冻结信用金额,单位为:元(人民币),精确到小数点后两位
【示例值】0.01
total_freeze_fund_amount特殊可选price(11)
【描述】累计冻结自有资金金额,单位为:元(人民币),精确到小数点后两位
【示例值】0.01
total_pay_credit_amount特殊可选price(11)
【描述】累计支付信用金额,单位为:元(人民币),精确到小数点后两位
【示例值】0.01
total_pay_fund_amount特殊可选price(11)
【描述】累计支付自有资金金额,单位为:元(人民币),精确到小数点后两位
【示例值】0.01
rest_credit_amount特殊可选price(11)
【描述】剩余冻结信用金额,单位为:元(人民币),精确到小数点后两位
【示例值】0.01
rest_fund_amount特殊可选price(11)
【描述】剩余冻结自有资金金额,单位为:元(人民币),精确到小数点后两位
【示例值】0.01
credit_amount特殊可选price(11)
【描述】该笔资金操作流水operation_id对应的操作信用金额
【示例值】0.01
fund_amount特殊可选price(11)
【描述】该笔资金操作流水operation_id对应的操作自有资金金额
【示例值】0.01
credit_merchant_ext特殊可选string(128)
【描述】芝麻透出给商户的信息,具体内容由商户与芝麻约定后返回
【示例值】{"1003190":"true"}
payer_logon_id可选string(100)
【描述】付款方支付宝账号(email或手机号),仅作展示使用,默认会加“*”号处理
【示例值】ali*@alipay.com
gmt_trans可选date(20)
【描述】支付宝账务处理成功时间, 格式:yyyy-mm-dd hh:mm:ss
【示例值】2014-01-01 20:00:00
响应示例
{
    "alipay_fund_auth_operation_detail_query_response": {
        "code": "10000",
        "msg": "success",
        "auth_no": "2014031600002001260000001000",
        "out_order_no": "20140216001",
        "order_status": "authorized",
        "total_freeze_amount": "4800.00",
        "rest_amount": "4600.00",
        "total_pay_amount": "0.00",
        "order_title": "0元购土豪金",
        "payer_logon_id": "ali*@alipay.com",
        "payer_user_id": "2088402019148643",
        "payer_open_id": "03914imefxss9k-tsvhy-iisrllofthfgdvo-hu30xtkpg9",
        "extra_param": "{\"merchantext\":\"key1=value1,key2=value2\"}",
        "operation_id": "20140216355864862002",
        "out_request_no": "20140216001001",
        "amount": "200.00",
        "operation_type": "unfreeze",
        "status": "success",
        "remark": "2014-05期解冻200.00元",
        "gmt_create": "2014-01-01 20:00:00",
        "gmt_trans": "2014-01-01 20:00:00",
        "pre_auth_type": "credit_auth",
        "trans_currency": "usd",
        "total_freeze_credit_amount": "0.01",
        "total_freeze_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",
        "credit_amount": "0.01",
        "fund_amount": "0.01",
        "credit_merchant_ext": "{\"1003190\":\"true\"}"
    },
    "sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}
说明:本示例仅供参考。

公共错误码

业务错误码

错误码错误描述凯发app官方网站的解决方案
system_error系统繁忙
服务器异常 可能发生了网络或者系统异常,导致服务调用失败,商户可以用同样的请求发起重试
access_forbidden无权限使用该产品
未签约或签约已到期,请检查合约
auth_operation_not_exist支付宝资金操作流水不存在
检查传入参数中的支付宝的授权资金操作流水号或商户的授权资金操作流水号,修改后重新发起请求
auth_order_not_exist支付宝资金授权订单不存在
检查传入参数中的支付宝资金授权订单号或商户授权订单号,修改后重新发起请求
enterprise_pay_biz_error因公付业务异常
请使用相同参数再次调用
has_no_privilege商户无权限查看该笔订单信息
请检查该商户是否创建了该笔授权订单
illegal_argument参数异常或参数缺失
检查请求参数,修改后重新发起请求
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 2022 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
为开发者能享受更简单的协议处理逻辑、更丰富的开源工具配套、更低的接口响应时延,支付宝开放平台推出符合oas3.0规范的,助力开发体验。新版本文档请点击“查看v3版本”进行访问。
网站地图