通用场景
通过该接口可以查询单笔明细的详细信息
1、请求与响应参数中的 operation_type 均表示当前查询的资金操作类型
2、查询冻结明细时,out_request_no 传入发起冻结操作时的 out_request_no,operation_type 默认为freeze,可不传入;
3、查询解冻明细时,out_request_no 传入发起解冻操作时的 out_request_no,operation_type 需传入unfreeze;
4、查询支付明细时,out_request_no 需要传入发起转支付时传入的 out_trade_no 参数值,operation_type 需传入pay;
5、如果是使用 complete 模式发起的转支付(转交易的同时剩余金额解冻),需要查询关联的解冻明细,此时 out_request_no 同样传入转支付时传入的 out_trade_no,operation_type 需传入 unfreeze;
6、注意区分查询结果中返回的 status 和 order_status 字段,status 表示当前资金操作的状态;order_status 表示当前授权单的状态,详细状态枚举见参数描述。
2、查询冻结明细时,out_request_no 传入发起冻结操作时的 out_request_no,operation_type 默认为freeze,可不传入;
3、查询解冻明细时,out_request_no 传入发起解冻操作时的 out_request_no,operation_type 需传入unfreeze;
4、查询支付明细时,out_request_no 需要传入发起转支付时传入的 out_trade_no 参数值,operation_type 需传入pay;
5、如果是使用 complete 模式发起的转支付(转交易的同时剩余金额解冻),需要查询关联的解冻明细,此时 out_request_no 同样传入转支付时传入的 out_trade_no,operation_type 需传入 unfreeze;
6、注意区分查询结果中返回的 status 和 order_status 字段,status 表示当前资金操作的状态;order_status 表示当前授权单的状态,详细状态枚举见参数描述。
公共请求参数
业务请求参数
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"
}'
说明:本示例仅供参考。
公共响应参数
业务响应参数
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 | 参数异常或参数缺失 | 检查请求参数,修改后重新发起请求 |