注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > 花呗预授权

资金授权订单操作流水查询接口(alipay.fund.auth.operation.query)

更新时间:2016/06/22 访问次数:3053

功能描述

商户可以查询资金授权订单的操作流水信息,默认100条/页。

请求地址

环境 HTTPS网关
正式环境 https://mapi.alipay.com/gateway.do

请求参数说明

参数

参数名称

类型(字节长度)

参数说明

是否可为空

样例

基本参数

service

接口名称

String

接口名称。

不可空

alipay.fund.auth.operation.query

partner

合作者身份ID

String(16)

签约的支付宝账号对应的支付宝唯一用户号。

以2088开头的16位纯数字组成。

不可空

2088001159940003

_input_charset

参数编码字符集

String

商户网站使用的编码格式,如utf-8、gbk、gb2312等。

不可空

GBK

sign_type

签名方式

String

DSA、RSA、MD5三个值可选,必须大写。

不可空

DSA

sign

签名

String

请参见“ 签名机制”。

不可空

_p_w_l_h_j0b_gd_aejia7n_ko4_m%252Fu_w_jd3_nx_s_k_mxus9_hoxg_y_r_lunli_pmma29_t_q%3D%3D

业务参数

auth_no

支付宝资金授权订单号

String(64)

支付宝资金授权订单号。

auth_no和out_order_no不能同时为空。如果本字段非空则优先以本字段进行查询。

可空

2014021601002000640012345678

out_order_no

商户资金授权订单号

String(64)

商户的授权资金订单号。

auth_no和out_order_no不能同时为空。

可空

20140216001

operation_id

支付宝资金操作流水号

String(64)

支付宝资金操作流水号。

可空

2014021601002001640087654321

out_request_no

商户请求流水号

String(64)

商户请求流水号。

可空

20140216001001

operation_type

操作类型

String

支付宝资金操作类型。

目前支持:

  • FREEZE:冻结

  • UNFREEZE:解冻

  • PAY:支付

  • 可空

    FREEZE

    status

    操作流水状态

    String

    资金操作流水的状态。

    目前支持:

  • INIT:初始

  • PROCESSING:处理中

  • SUCCESS:成功

  • FAIL:失败

  • CLOSED:关闭

  • 可空

    SUCCESS

    operation_time_begin

    操作起始时间

    String

    根据操作创建时间来查询操作明细。

    起始时间和截止时间或者都为空,或者都非空。

    格式:YYYY-MM-DD HH:MM:SS。

    可空

    2014-01-01 00:00:00

    operation_time_end

    操作截止时间

    String

    根据操作创建时间来查询操作明细。


    起始时间和截止时间或者都为空,或者都非空。

    格式:YYYY-MM-DD HH:MM:SS。

    与operation_time_begin间隔不能超过31天。

    可空

    2014-01-05 00:00:00

    page

    查询页码

    Number

    采用分页查询机制,每页返回100条流水。

    如果为空默认查询第1页。

    可空

    1

    请求示例

    https://mapi.alipay.com/gateway.do?service=alipay.fund.auth.operation.query&partner=2088001159940003&_input_charset=GBK&sign_type=DSA&sign=_p_w_l_h_j0b_gd_aejia7n_ko4_m%252Fu_w_jd3_nx_s_k_mxus9_hoxg_y_r_lunli_pmma29_t_q%3D%3D&auth_no=2014021601002000640012345678&out_order_no=20140216001&operation_id=2014021601002001640087654321&out_request_no=20140216001001&operation_type=FREEZE&status=SUCCESS&operation_time_begin=2014-01-01+00%3A00%3A00&operation_time_end=2014-01-05+00%3A00%3A00

    xml同步返回参数说明

    参数

    参数名称

    类型(长度范围)

    参数说明

    是否可为空

    样例

     

    基本参数

    is_success

    是否成功

    String

    请求是否成功。请求成功不代表业务处理成功。

  • T代表成功

  • F代表失败

  • 不可空

    T

    sign

    签名

    String

    请参见“签名机制”。

    可空

    8d34527bb746762b5ddc764e7fdea9af

    sign_type

    签名方式

    String

    DSA、RSA、MD5三个值可选,必须大写。

    可空

    MD5

    error

    错误代码

    String

  • 请求成功时,不存在本参数;

  • 请求失败时,本参数为错误代码,参见接入错误码”和“系统错误码”。

  • 可空

    ILLEGAL_SIGN

    业务参数

    result_code

    处理结果码

    String

    处理结果代码。当处理结果码不是SUCCESS时,其他业务参数均可能为空!

    请参见“资金授权订单操作流水查询业务处理结果码”。

    不可空

    SUCCESS

    result_message

    处理结果描述

    String

    详细描述处理失败的原因。

    请参见“资金授权订单操作流水查询业务处理结果码”中的“含义”。

    可空

    非法参数

    page

    当前页码

    Number

    当前结果的页码,对应请求参数的page字段。

    不可空

    1

    pages

    总页数

    Number

    根据条件查询到的结果总页数,默认100项/页。

    不可空

    2

    items

    总记录数

    Number

    根据条件查询到的结果记录总条数。

    不可空

    120

    auth_no

    支付宝资金授权订单号

    String(64)

    支付宝资金授权订单号。

    不可空

    2014021601002000640012345678

    out_order_no

    商户资金授权订单号

    String(64)

    商户的授权资金订单号。

    如果查询条件中填写了此参数则直接返回,否则为空。

    可空

    20140216001

    operatioin_list

    资金授权订单操作流水列表

    String

    资金授权订单操作流水列表。

    可能包含多个<operation>子节点。

    <operation>节点参数请参见“ operation节点参数列表”。

    不可空

    参见“样例”的“正常输出”

    • operation节点参数列表

    参数

    参数名称

    类型(长度范围)

    参数说明

    是否可为空

    样例

    operation_id

    支付宝资金操作流水号

    String

    支付宝资金操作流水号。

    不可空

    2014021601002001640087654321

    out_request_no

    商户请求流水号

    String

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

    不可空

    20140216001001

    operation_type

    操作类型

    String

    支付宝资金操作类型。

    目前支持:

  • FREEZE:冻结

  • UNFREEZE:解冻

  • PAY:支付

  • 不可空

    FREEZE

    amount

    操作金额

    String

    本次操作冻结/解冻的金额,单位为:元(人民币)。

    不可空

    4800.00

    status

    操作流水状态

    String

    资金操作流水的状态。

    目前支持:

  • INIT:初始

  • PROCESSING:处理中

  • SUCCESS:成功

  • FAIL:失败

  • CLOSED:关闭

  • 不可空

    SUCCESS

    gmt_create

    操作创建时间

    String

    资金授权单据操作创建时间。

    格式:YYYY-MM-DD HH:MM:SS。

    不可空

    2014-01-01 20:00:00

    payer_logon_id

    付款方支付宝账号

    String(100)

    付款方支付宝账号(Email或手机号)。

    仅作展示使用,默认会加“*”号处理。

    可空

    ali*@alipay.com

    payer_user_id

    付款方支付宝用户号

    String(32)

    付款方支付宝账号对应的支付宝唯一用户号。

    以2088开头的16位纯数字组成。

    可空

    2088402019148643

    payee_logon_id

    收款方支付宝账号

    String(100)

    如果操作类型为支付,该字段标识当前操作收款方支付宝账号(Email或手机号)。

    商户请求支付时传递给交易的收款方登录号。

    可空

    test*@alipay.com

    payee_user_id

    收款方支付宝用户号

    String(32)

    如果操作类型为支付,该字段标识当前操作收款方支付宝账号对应的支付宝唯一用户号。

    以2088开头的16位纯数字组成。

    商户请求支付时传递给交易的收款方支付宝用户号。

    可空

    2088400012341234

    remark

    业务描述

    String(100)

    商户对本次操作的附言描述。长度不超过100个字母或50个汉字。

    可空

    2014-05期解冻200.00元

    target_order_no

    目标业务单据号

    String(64)

    当操作类型为支付时,该字段标识该笔资金用于支付交易的交易号。

    可空

    2014010111001004390000105126

    target_order_type

    目标业务单据类型

    String(20)

    当操作类型为支付时,该字段标识target_order_no的类型。

    目前仅支持:TRADE_NO(交易号)。

    可空

    TRADE_NO

    gmt_trans

    操作处理成功时间

    String

    支付宝账务处理成功时间。

    格式:YYYY-MM-DD HH:MM:SS。

    可空

    2014-01-01 20:00:00

    同步返回示例

    • 正常输出:
    <alipay>
        <is_success>T</is_success>
        <request>
            <param name="service">alipay.fund.auth.operation.query</param>
            <param name="partner">2088001159940003</param>
            <param name="_input_charset ">GBK</param>
            <param name="auth_no">2014021601002000640012345678</param>
            <param name="out_order_no">20140216001</param>
            <param name="operation_id">2014021601002001640087654321</param>
            <param name="out_request_no">20140216001001</param>
            <param name="operation_type">FREEZE</param>
            <param name="status">SUCCESS</param>
            <param name="operation_time_begin">2014-01-01 00:00:00</param>
            <param name="operation_time_end">2014-01-05 00:00:00</param>
        </request>
        <response>
            <order>
                <result_code>SUCCESS</result_code>
                <page>1</page>
                <pages>2</pages>
                <items>120</items>
                <auth_no>2014021601002000640012345678</auth_no>
                <out_order_no>20140216001</out_order_no>
                <operatioin_list>
                    <operation>
                        <operation_id>2014021601002001640087654321
                        </operation_id>
                        <out_request_no>20140216001001</out_request_no>
                        <operation_type>FREEZE</operation_type>
                        <payer_logon_id>ali*@alipay.com</payer_logon_id>
                        <payer_user_id>2088402019148643</payer_user_id>
                        <remark>2014-05期解冻200.00元</remark>
                        <amount>4800.00</amount>
                        <status>SUCCESS</status>
                        <gmt_trans>2014-01-01 20:00:00</gmt_trans>
                        <gmt_create>2014-01-01 20:00:00</gmt_create>
                    </operation>
                </operatioin_list>
            </order>
        </response>
        <sign>8d34527bb746762b5ddc764e7fdea9af</sign>
        <sign_type>MD5</sign_type>
    </alipay>
    • 业务处理发生错误时输出:
    <alipay>
        <is_success>T</is_success>
        <request>
            <param name="service">alipay.fund.auth.operation.query</param>
            <param name="partner">2088001159940003</param>
            <param name="_input_charset ">GBK</param>
            <param name="auth_no">2014021601002000640012345678</param>
            <param name="out_order_no">20140216001</param>
            <param name="operation_id">2014021601002001640087654321</param>
            <param name="out_request_no">20140216001001</param>
            <param name="operation_type">FREEZE</param>
            <param name="status">SUCCESS</param>
            <param name="operation_time_begin">2014-01-01 00:00:00</param>
            <param name="operation_time_end">2014-01-05 00:00:00</param>
        </request>
        <response>
            <order>
                <result_code>ILLEGAL_ARGUMENT</result_code>
                <result_message>非法参数</result_message>
            </order>
        </response>
        <sign>8d34527bb746762b5ddc764e7fdea9af</sign>
        <sign_type>MD5</sign_type>
    </alipay>
    • 请求发生错误时输出:
    <?xml version="1.0" encoding="utf-8"?>
    <alipay>
        <is_success>F</is_success>
        <error>ILLEGAL_SIGN</error>
    </alipay>

    FAQ

    关于此文档暂时还没有FAQ
    返回
    顶部