请求参数说明

请求参数是商户在与支付宝进行数据交互时，提供给支付宝的请求数据，以便支付宝根据这些数据进一步处理。

https://mapi.alipay.com/gateway.do?out_request_nos=201506010001%2C201506010002%2C201506010003&sign_type=MD5&sign=b7baf9af3c91b37bef4261849aa76281&_input_charset=UTF-8&service=alipay.overseas.acquire.customs.query&partner=2088101568338364

说明：
本样例仅供参考，支付宝网关为https://mapi.alipay.com/gateway.do。

同步返回参数说明

支付宝对商户提供的请求数据进行处理后，返回给商户结果数据，以便商户根据这些数据进一步处理。

返回结果分两种场景，一种为业务正常受理的结果，一种为系统级异常或者接入数据错误。对于业务正常受理，商户需要解析响应码以判断业务是否处理成功。

说明：
同步返回的参数随支付宝服务端的演化，可能会返回更多的节点，需要程序使用方对文档说明以外的节点予以忽略。

• 查询成功返回样例

<?xml version="1.0" encoding="utf-8"?>
<alipay>
    <is_success>T</is_success>
    <request>
        <param name="sign">eb9ece9d658e7a9671411d1b43b5750c</param>
        <param name="_input_charset">UTF-8</param>
        <param name="sign_type">MD5</param>
        <param name="service">alipay.overseas.acquire.customs.query</param>
        <param name="out_request_nos">4877067126133624,7665166179649532</param>
        <param name="partner">2088101143686350</param>
    </request>
    <response>
        <alipay>
            <records>
                <customs_declare>
                    <alipay_declare_no>2015082011082370647505271</alipay_declare_no>
                    <amount>1.00</amount>
                    <is_split>T</is_split>
                    <sub_out_biz_no>999999999999999</sub_out_biz_no>
                    <customs_place>hangzhou</customs_place>
                    <last_modified_time>2015-10-15 14:24:56</last_modified_time>
                    <memo/>
                    <merchant_customs_code>code</merchant_customs_code>
                    <merchant_customs_name>1</merchant_customs_name>
                    <out_request_no>4877067126133624</out_request_no>
                    <status>succ</status>
                    <trade_no>2015082011082370647505271</trade_no>
                    <customs_code>2</customs_code>
                    <customs_info>新增申报成功[B0B2F23E-2CF6-434D-9F24-8931B835A056]</customs_info>
                    <customs_return_time>20160414142358</customs_return_time>
                </customs_declare>
                <customs_declare>
                    <alipay_declare_no>2015081811082379147506255</alipay_declare_no>
                    <amount>1.00</amount>
                    <customs_place>henan</customs_place>
                    <last_modified_time>2015-10-15 14:24:56</last_modified_time>
                    <memo/>
                    <merchant_customs_code>code</merchant_customs_code>
                    <merchant_customs_name>name</merchant_customs_name>
                    <out_request_no>7665166179649532</out_request_no>
                    <status>succ</status>
                    <trade_no>2015081710650237</trade_no>
                    <customs_code>2</customs_code>
                    <customs_info>新增申报成功[B0B2F23E-2CF6-434D-9F24-8931B835A056]</customs_info>
                    <customs_return_time>20160414142358</customs_return_time>
                </customs_declare>
            </records>
            <result_code>SUCCESS</result_code>
        </alipay>
    </response>
    <sign>15669c65f3d19d0691425bba349a8b55</sign>
    <sign_type>MD5</sign_type>
</alipay>

• 请求成功，业务处理失败返回样例

<?xml version="1.0" encoding="utf-8"?>
<alipay>
    <is_success>T</is_success>
    <request>
        <param name="sign">48201072f0d0991c3bab798d963c6cd8</param>
        <param name="_input_charset">UTF-8</param>
        <param name="sign_type">MD5</param>
        <param name="service">alipay.overseas.acquire.customs.query</param>
        <param name="out_request_nos">4877067126133624,7665166179649532,,</param>
        <param name="partner">2088101143686350</param>
    </request>
    <response>
        <alipay>
            <detail_error_code>INVALID_PARAMETER</detail_error_code>
            <detail_error_des>报关单参数不合法</detail_error_des>
            <result_code>FAIL</result_code>
        </alipay>
    </response>
    <sign>48fd2067e7fa2a7e779465d9e80dced5</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>

同步返回特性

1. 支付宝处理完商户的请求数据后，当前的支付宝网关页面（https://mapi.alipay.com）会自动刷新，并立刻输出处理结果；
2. 处理一次请求，当前界面只跳转回来一次，即只返回一次处理结果；
3. 该步骤可在本机电脑调试，无需到服务器上；
4. 处理结果显示的格式是XML格式；
5. 可对这个XML格式的处理结果进行XML远程解析，使之能在支付宝处理结果时获取到相关处理结果数据，并对这个结果界面进行商户的业务逻辑处理；
6. 本地电脑或商户服务器的配置上需支持XML远程解析，如：需要支持SSL；
7. 页面跳转后，浏览器地址栏中的链接仅在一分钟内有效，超过一分钟该链接地址会失效，导致该页面中商户编写的业务逻辑程序无法完成处理。

业务错误码

FAQ