交易请求报文

JSON:

 复制代码
{
    "request_type": "barcode_pay_request",
    "isspid": "39493002",
    "pos_id": "1511300001",
    "store_id": "1511300001",
    "pos_seq": "1511300000002",
    "user_id": "user01",
    "system_id": "8888",
    "device_ip": "127.0.0.1",
    "latitude": "+37.12",
    "longitude": "-121.213",
    "memo": "订单备注",
    "barcode_pay_request": {
        "barcode_info": "1234567890123456",
        "pay_type": "502",
        "tx_amt": "1000",
        "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"
                    }
                ]
            }
        },
        "use_coupon": "1"
    },
    "sign": "EB0F3B9404AAFC27C520C1D64A69C169"
}

XML:

 复制代码
<?xml version="1.0" encoding="GBK"?>
<business_trans>
    <request_type>barcode_pay_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>
    <latitude>+37.12</latitude>
    <longitude>-121.213</longitude>
    <memo>订单备注</memo>
    <barcode_pay_request>
        <barcode_info>1234567890123456</barcode_info>
        <pay_type>502</pay_type>
        <tx_amt>10</tx_amt>
        <goods_detail><![CDATA[商品信息(JSON)]]></goods_detail>
        <extend_params><![CDATA[扩展参数(JSON)]]></extend_params>
        <use_coupon>1</use_coupon>
    </barcode_pay_request>
</business_trans>

交易请求报文说明

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

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",
        "addn_info" : "商品图片 http://www.95516.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",
        "addn_info" : "商品图片 http://www.95516.com/xxx.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": "barcode_pay_response",
    "isspid": "39493002",
    "pos_id": "8888888888",
    "pos_seq": "2018121400000001",
    "trans_time": "20181214135756",
    "pay_type": "502",
    "extend": "<![CDATA[]]>",
    "sys_seq": "5d170b6b78a0cb13",
    "buss_discount_amt": 0,
    "platform_discount_amt": 0,
    "discount_amt": 0,
    "mdiscount_amt": 0,
    "coupon_amt": 0,
    "mcard_amt": 0,
    "mcoupon_amt": 0,
    "point_amt": 0,
    "memo": "订单备注",
    "alipay_res_info": {
        "trade_no": "2018121422001429700548119225",
        "out_trade_no": "0001056562600000122014",
        "atu_trade_no": "2018121422001429700548119225",
        "atu_out_trade_no": "0001056562600000122014",
        "buy_user_id": "",
        "buy_logon_id": "",
        "gmt_payment": "20181214135757",
        "total_fee": "1",
        "receipt_amount": "1",
        "invoice_amount": "1",
        "buyer_pay_amount": "1",
        "charge_amount": "0",
        "fee_allowance_info": "{\"receivable_fee_amt\":\"2\",\"actual_fee_amt\":\"1\",\"allowance_fee_amt\":\"1\"}",
        "fund_bill_list": [
            {
                "amount": "1",
                "fund_channel": "ALIPAYACCOUNT"
            },
            {
                "amount": "1",
                "fund_channel": "COUPON"
            }
        ],
        "voucher_detail_list": [
            {
                "amount": "1000",
                "id": "2015102600073002039000002D5O",
                "memo": "学生专用优惠",
                "merchant_contribute": "900",
                "name": "XX超市5折优惠",
                "other_contribute": "100",
                "type": "ALIPAY_FIX_VOUCHER",
                "discount_goods_detail": [
                    {
                        "goods_id": "STANDARD1026181538",
                        "goods_name": "雪碧",
                        "discount_amount": "10000",
                        "voucher_id": "2015102600073002039000002D5O"
                    }
                ]
            },
            {
                "amount": "1000",
                "id": "2015102600073002039000002D5O",
                "memo": "学生专用优惠",
                "merchant_contribute": "900",
                "name": "XX超市5折优惠",
                "other_contribute": "100",
                "type": "ALIPAY_FIX_VOUCHER",
                "discount_goods_detail": [
                    {
                        "goods_id": "STANDARD1026181538",
                        "goods_name": "雪碧",
                        "discount_amount": "10000",
                        "voucher_id": "2015102600073002039000002D5O"
                    }
                ]
            }
        ],
        "detail_error_code": "10000",
        "detail_error_desc": "Success"
    },
    "wxpay_res_info": {
        "buyer_pay_amount": 1,
        "trade_no": "4200000196201812146252898537",
        "out_trade_no": "2018121400000002",
        "atu_trade_no": "4200000196201812146252898537",
        "atu_out_trade_no": "2018121400000002",
        "app_id": "wx5acb63e448b4fc22",
        "mch_id": "1241109502",
        "open_id": "oVTJstwEIdlt3ExaSCxF_cfdRADE",
        "is_subscribe": "N",
        "sub_openid": "oXI_E5KN-FJi1Hf65mWeiBF8fUlU",
        "sub_is_subscribe": "",
        "trade_type": "MICROPAY",
        "bank_type": "CFT",
        "total_fee": "1",
        "coupon_fee": "",
        "charge_amount": "0",
        "fee_allowance_info": "{\"receivable_fee_amt\":\"2\",\"actual_fee_amt\":\"1\",\"allowance_fee_amt\":\"1\"}",
        "gmt_payment": "20181214141132",
        "detail_error_code": "SUCCESS",
        "detail_error_desc": "OK",
        "settlement_total_fee": "1",
        "promotion_detail": {
            "promotion_detail": [
                {
                    "promotion_id": "109519",
                    "name": "单品惠-6",
                    "scope": "SINGLE",
                    "type": "DISCOUNT",
                    "amount": 5,
                    "activity_id": "931386",
                    "wxpay_contribute": 0,
                    "merchant_contribute": 0,
                    "other_contribute": 5,
                    "goods_detail": [
                        {
                            "goods_id": "a_goods1",
                            "goods_remark": "商品备注",
                            "quantity": 7,
                            "price": 1,
                            "discount_amount": 4
                        },
                        {
                            "goods_id": "a_goods2",
                            "goods_remark": "商品备注",
                            "quantity": 1,
                            "price": 2,
                            "discount_amount": 1
                        }
                    ]
                }
            ]
        }
    },
    "upay_res_info": {
        "trade_no": "20180504050741694554",
        "out_trade_no": "1805040000021",
        "atu_trade_no": "20180504050741694554",
        "atu_out_trade_no": "1805040000021",
        "buyer_pay_amount": "1",
        "total_fee": "1",
        "charge_amount": "0",
        "fee_allowance_info": "{\"receivable_fee_amt\":\"2\",\"actual_fee_amt\":\"1\",\"allowance_fee_amt\":\"1\"}"
    },
    "ecny_res_info": {
        "trade_no": "20180504050741694554",
        "out_trade_no": "1805040000021",
        "buyer_pay_amount": "1"
        "total_fee": "1",
        "receipt_fee": "1",
        "charge_amount": "0",
        "gmt_payment": "20210205113225",
        "detail_error_code": "",
        "detail_error_desc": ""
    },
    "balpay_res_info": {
        "trade_no": "20180504050741694554",
        "out_trade_no": "1805040000021",
        "total_fee": "25",
        "charge_amount": "0",
        "gmt_payment": "20230530105300",
        "member_id": "1542"
    },
    "result": {
        "id": "0000",
        "comment": "交易成功"
    },
    "sign": "C557C5D68AA5D803B2E6FF54AA28E5DF"
}

XML:

 复制代码
<?xml version="1.0" encoding="GBK"?>
<business_trans>
    <response_type>barcode_pay_response</response_type>
    <isspid>39493002</isspid>
    <pos_id>123456789</pos_id>
    <pos_seq>000000000001</pos_seq>
    <sys_seq>000000000244</sys_seq>
    <trans_time>20090405010104</trans_time>
    <pay_type>502</pay_type>
    <extend><![CDATA[扩展字段(json格式)]]></extend>
    <buss_discount_amt>2</buss_discount_amt>
    <platform_discount_amt>2</platform_discount_amt>
    <discount_amt>0</discount_amt>
    <mdiscount_amt>0</mdiscount_amt>
    <coupon_amt>0</coupon_amt>
    <mcard_amt>0</mcard_amt>
    <mcoupon_amt>0</mcoupon_amt>
    <point_amt>0</point_amt>
    <memo>订单备注</memo>
    <alipay_res_info>
        <trade_no>2018111522001429701012895360</trade_no>
        <out_trade_no>1811150000001</out_trade_no>
        <atu_trade_no>2018111522001429701012895360</atu_trade_no>
        <atu_out_trade_no>1811150000001</atu_out_trade_no>
        <buy_user_id>2088123456789012</buy_user_id>
        <buy_logon_id>502***@qq.com</buy_logon_id>
        <total_fee>1</total_fee>
        <receipt_amount>1</receipt_amount>
        <invoice_amount>1</invoice_amount>
        <buyer_pay_amount>1</buyer_pay_amount>
        <charge_amount>0</charge_amount>
        <fee_allowance_info>[{手续费补贴信息(JOSN)}]</fee_allowance_info>
        <fund_bill_list></fund_bill_list>
        <gmt_payment>20181115085738</gmt_payment>
        <detail_error_code></detail_error_code>
        <detail_error_desc></detail_error_desc>
        <voucher_detail_list>[{单品优惠信息(JOSN)}]</voucher_detail_list>
    </alipay_res_info>
    <wxpay_res_info>
        <trade_no>4001172001201604144821605495</trade_no>
        <out_trade_no>1811150000002</out_trade_no>
        <atu_trade_no>4001172001201604144821605495</atu_trade_no>
        <atu_out_trade_no>1811150000002</atu_out_trade_no>
        <app_id>wx5acb63e448b4fc22</app_id>
        <mch_id>1241109502</mch_id>
        <open_id>oVTJstwEIdlt3ExaSCxF_cfdRADE</open_id>
        <is_subscribe>N</is_subscribe>
        <sub_openid>oXI_E5KN-FJi1Hf65mWeiBF8fUlU</sub_openid>
        <sub_is_subscribe>N</sub_is_subscribe>
        <trade_type>MICROPAY</trade_type>
        <bank_type>CCB_DEBIT</bank_type>
        <total_fee>1</total_fee>
        <coupon_fee>0</coupon_fee>
        <charge_amount>0</charge_amount>
        <fee_allowance_info>[{手续费补贴信息(JOSN)}]</fee_allowance_info>
        <gmt_payment>20181115090351</gmt_payment>
        <detail_error_code>SUCCESS</detail_error_code>
        <detail_error_desc>OK</detail_error_desc>
        <promotion_detail>[{单品优惠信息(JOSN)}]</promotion_detail>
        <buyer_pay_amount>1</buyer_pay_amount>
        <settlement_total_fee>1</settlement_total_fee>
    </wxpay_res_info>
    <upay_res_info>
        <trade_no>20180504050741694554</trade_no>
        <out_trade_no>1805040000021</out_trade_no>
        <atu_trade_no>20180504050741694554</atu_trade_no>
        <atu_out_trade_no>1805040000021</atu_out_trade_no>
        <buyer_pay_amount>1</buyer_pay_amount>
        <total_fee>1</total_fee>
        <charge_amount>0</charge_amount>
        <fee_allowance_info>[{手续费补贴信息(JOSN)}]</fee_allowance_info>
    </upay_res_info>
    <ecny_res_info>
        <trade_no>20180504050741694554</trade_no>
        <out_trade_no>1805040000021</out_trade_no>
        <buyer_pay_amount>1</buyer_pay_amount>
        <total_fee>1</total_fee>
        <receipt_fee>1</receipt_fee>
        <charge_amount>0</charge_amount>
        <gmt_payment>20210205113225</gmt_payment>
        <detail_error_code></detail_error_code>
        <detail_error_desc></detail_error_desc>
    </ecny_res_info>
    <balpay_res_info>
        <trade_no>20180504050741694554</trade_no>
        <out_trade_no>1805040000021</out_trade_no>
        <total_fee>25</total_fee>
        <charge_amount>0</charge_amount>
        <gmt_payment>20230530105300</gmt_payment>
        <member_id>1542</member_id>
    </balpay_res_info>
    <result>
        <id>0000</id>
        <comment>成功</comment>
    </result>
</business_trans>

交易返回报文说明

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

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

voucher_detail_list 优惠券信息

voucher_detail_list 样例：

 复制代码
[
    {
        "amount":"1000",
        "id":"2015102600073002039000002D5O",
        "memo":"学生专用优惠",
        "merchant_contribute":"900",
        "name":"XX超市5折优惠",
        "other_contribute":"100",
        "type":"ALIPAY_FIX_VOUCHER",
        "discount_goods_detail":[
            {
                "goods_id":"STANDARD1026181538",
                "goods_name":"雪碧",
                "discount_amount":"10000",
                "voucher_id":"2015102600073002039000002D5O"
            }
        ]
    },
    {
        "amount":"1000",
        "id":"2015102600073002039000002D5O",
        "memo":"学生专用优惠",
        "merchant_contribute":"900",
        "name":"XX超市5折优惠",
        "other_contribute":"100",
        "type":"ALIPAY_FIX_VOUCHER",
        "discount_goods_detail":[
            {
                "goods_id":"STANDARD1026181538",
                "goods_name":"雪碧",
                "discount_amount":"10000",
                "voucher_id":"2015102600073002039000002D5O"
            }
        ]
    }
]

promotion_detail 优惠活动信息

promotion_detail 样例：

 复制代码
{
    "promotion_detail": [
        {
            "promotion_id": "109519",
            "name": "单品惠-6",
            "scope": "SINGLE",
            "type": "DISCOUNT",
            "amount": 5,
            "activity_id": "931386",
            "wxpay_contribute": 0,
            "merchant_contribute": 0,
            "other_contribute": 5,
            "goods_detail": [
                {
                    "goods_id": "a_goods1",
                    "goods_remark": "商品备注",
                    "quantity": 7,
                    "price": 1,
                    "discount_amount": 4
                },
                {
                    "goods_id": "a_goods2",
                    "goods_remark": "商品备注",
                    "quantity": 1,
                    "price": 2,
                    "discount_amount": 1
                }
            ]
        }
    ]
}

fee_allowance_info 手续费补贴信息 (JSONString)

cur_allowance_config_infos 手续费补贴活动详情 (JSONObject)