交易请求报文

JSON:

{
    "request_type": "bcm_ordercreate_request",
    "isspid": "39493002",
    "pos_id": "1511300001",
    "store_id": "1511300001",
    "pos_seq": "2018121400000004",
    "user_id": "user01",
    "system_id": "8888",
    "memo": "订单备注",
    "bcm_ordercreate_request": {
        "pos_sn": "",
        "terminal_id": "0001045907",
        "tx_amt": "1",
        "notify_url": "http://www.baidu.com/",
        "goods_detail": [
            {
                "goods_name": "啊ipad",
                "quantity": 1,
                "price": 200000
            },
            {
                "goods_name": "额ipad2",
                "quantity": 1,
                "price": 200000
            }
        ],
        "extend_params": {
            "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>bcm_ordercreate_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>
    <memo>订单备注</memo>
    <bcm_ordercreate_request>
        <pos_sn></pos_sn>
        <terminal_id>0001045907</terminal_id>
        <tx_amt>1</tx_amt>
        <notify_url><![CDATA[http://www.baidu.com/]]></notify_url>
        <extend_params><![CDATA[
            {
                "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"
                        }
                    ]
                }
            }
        ]]></extend_params>
        <goods_detail><![CDATA[
            [
                {
                    "goods_name": "啊ipad",
                    "quantity": 1,
                    "price": 200000
                },
                {
                    "goods_name": "额ipad2",
                    "quantity": 1,
                    "price": 200000
                }
            ]
        ]]></goods_detail>
    </bcm_ordercreate_request>
</business_trans>

交易请求报文说明

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

关于订单推送设备的特别说明

刷卡POS机身号(pos_sn) 和 刷卡POS终端号(terminal_id)
两个节点对应不同版本的刷卡设备APP使用，不可同时使用
商户具体使用哪个节点，具体对接时与业务和技术对接人沟通
两个节点都不传，则不会推送订单，可以使用pos_seq生成二维码，刷卡设备扫码方式传递订单信息

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不允许传入，在后续流程中调用延迟交易确认接口完成分账，或使用翼码分账系统界面进行分账。
4. 刷卡设备只有使用指定版本的APP，才能支持分账业务，使用前务必咨询业务或技术对接人

split_info 分账信息

split_list 分账明细

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

extend_params 样例：

{
    "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"
            }
        ]
    }
}

goods_detail 商品信息 (JSONArray)

goods_detail 样例：

[
    {
        "goods_name": "啊ipad",
        "quantity": 1,
        "price": 200000
    },
    {
        "goods_name": "额ipad2",
        "quantity": 1,
        "price": 200000
    }
]

交易返回报文

JSON:

{
    "response_type": "bcm_ordercreate_response",
    "isspid": "39493002",
    "pos_id": "6666666666",
    "pos_seq": "2018121400000004",
    "trans_time": "20181214143516",
    "sys_seq": "0741136885a748c1",
    "result": {
        "id": "9998",
        "comment": "创建订单成功"
    },
    "sign": "F6106656C20AB23B547B0C30DD819793"
}

XML:

<?xml version="1.0" encoding="GBK"?>
<business_trans>
    <response_type>bcm_ordercreate_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>
    <result>
        <id>9998</id>
        <comment>创建订单成功</comment>
    </result>
</business_trans>

交易返回报文说明

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

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