交易请求报文

JSON:

{
    "request_type": "scanpay_request",
    "isspid": "39493002",
    "pos_id": "1511300001",
    "store_id": "1511300001",
    "pos_seq": "2018121400000004",
    "user_id": "user01",
    "system_id": "8888",
    "device_ip": "127.0.0.1",
    "memo": "订单备注",
    "scanpay_request": {
        "pay_type": "502",
        "tx_amt": "1",
        "bank_code": "",
        "payment_process": "01",
        "notify_url": "http://www.baidu.com/",
        "goods_detail": [
            {
                "goods_id": "apple-01",
                "payment_goods_id": "20010001",
                "goods_name": "ipad",
                "quantity": 1,
                "price": 200000,
                "goods_category": "34543238",
                "body": "特价手机",
                "show_url": "http://www.alipay.com/xxx.jpg"
            },
            {
                "goods_id": "apple-02",
                "payment_goods_id": "20010002",
                "goods_name": "ipad2",
                "quantity": 1,
                "price": 200000,
                "goods_category": "34543239",
                "body": "特价手机2",
                "show_url": "http://www.alipay.com/xxx2.jpg"
            }
        ],
        "extend_params": {
            "hb_fq_num": "3",
            "hb_fq_seller_percent": "100",
            "split_flag": "R",
            "plan_split_date": "20230418",
            "split_info": {
                "keep_amt": "800",
                "split_list": [
                    {
                        "merchant_id": "10000000000001",
                        "div_amt": "150"
                    },
                    {
                        "merchant_id": "10000000000002",
                        "div_amt": "50"
                    }
                ]
            }
        }
    },
    "sign": "314DA43E7E244105ECBD45F797264854"
}

XML:

<?xml version="1.0" encoding="GBK"?>
<business_trans>
    <request_type>scanpay_request</request_type>
    <isspid>39493002</isspid>
    <pos_id>1511300001</pos_id>
    <store_id>1511300001</store_id>
    <pos_seq>1511300000002</pos_seq>
    <user_id>user01</user_id>
    <system_id>8888</system_id>
    <device_ip>127.0.0.1</device_ip>
    <memo>订单备注</memo>
    <scanpay_request>
        <pay_type>502</pay_type>
        <tx_amt>1</tx_amt>
        <bank_code></bank_code>
        <payment_process>01</payment_process>
        <notify_url><![CDATA[http://www.baidu.com/]]></notify_url>
        <goods_detail><![CDATA[商品信息(JSON)]]></goods_detail>
        <extend_params><![CDATA[扩展参数(JSON)]]></extend_params>
    </scanpay_request>
</business_trans>

交易请求报文说明

自定义门店号(store_id)和自定义终端号(pos_id)需经过4.1终端绑定交易接口绑定成功过的值才可以调用，绑定一次即可不需要重复绑定。

bank_code 指定银行编码

goods_detail 商品信息 (JSONArray)

goods_detail 样例：

[
    {
        "goods_id" : "apple-01",
        "payment_goods_id" : "20010001",
        "goods_name" : "ipad",
        "quantity" : 1,
        "price" : 200000,
        "goods_category" : "34543238",
        "body" : "特价手机",
        "show_url" : "http://www.alipay.com/xxx.jpg"
    },
    {
        "goods_id" : "apple-02",
        "payment_goods_id" : "20010002",
        "goods_name" : "ipad2",
        "quantity" : 1,
        "price" : 200000,
        "goods_category" : "34543239",
        "body" : "特价手机2",
        "show_url" : "http://www.alipay.com/xxx2.jpg"
    }
]

extend_params 扩展参数 (JSON)

分账业务相关的特别说明：
1. split_flag=N 不分账时，split_info不允许传入；
2. split_flag=R 实时分账时，split_info必传，其中keep_amt与div_amt叠加必须全额分完整笔订单；
3. split_flag=D 延时分账时，split_info不允许传入，在后续流程中调用延迟交易确认接口完成分账，或使用翼码分账系统界面进行分账。

split_info 分账信息

split_list 分账明细

若业务涉及100%分账给接收方，请于业务对接人联系申请使用净值分账功能。

extend_params 样例：

{
    "hb_fq_num": "3",
    "hb_fq_seller_percent": "100",
    "split_flag": "R",
    "plan_split_date": "20230418",
    "split_info": {
        "keep_amt": "800",
        "split_list": [
            {
                "merchant_id": "10000000000001",
                "div_amt": "150"
            },
            {
                "merchant_id": "10000000000002",
                "div_amt": "50"
            }
        ]
    }
}

交易返回报文

JSON:

{
    "response_type": "scanpay_response",
    "isspid": "39493002",
    "pos_id": "6666666666",
    "pos_seq": "2018121400000004",
    "trans_time": "20181214143516",
    "sys_seq": "0741136885a748c1",
    "pay_type": "502",
    "code_url": "https://qr.alipay.com/bax03342mgh8qcnbqymn20f0",
    "extend": "",
    "result": {
        "id": "9998",
        "comment": "下单成功，等待用户支付"
    },
    "sign": "F6106656C20AB23B547B0C30DD819793"
}

XML:

<?xml version="1.0" encoding="GBK"?>
<business_trans>
    <response_type>scanpay_response</response_type>
    <isspid>39493002</isspid>
    <pos_id>1511300001</pos_id>
    <pos_seq>1511300000002</pos_seq>
    <sys_seq>0311095321465179</sys_seq>
    <trans_time>20160311095321</trans_time>
    <pay_type>502</pay_type>
    <code_url><![CDATA[weixin://wxpay/bizpayurl?pr=wkEAWjS]]></code_url>
    <extend><![CDATA[扩展字段(json格式)]]></extend>
    <result>
        <id>9998</id>
        <comment>下单成功，等待用户支付</comment>
    </result>
</business_trans>

交易返回报文说明

标准接口会因业务升级需要而新增节点，请在解析返回报文时避免新增未知节点产生的程序出错！

标准接口会因业务升级需要而新增节点，请在解析返回报文时避免新增未知节点产生的程序出错！