业务说明

商户系统调用本接口，将商户系统的门店和终端信息传给翼码，在翼码系统生成出对应门店和终端。

门店号(store_id)和终端号(pos_id)必须经过本接口绑定成功才可以用于调用其他接口。

若您的系统没有门店概念，门店号(store_id)、门店名称(store_name)与终端号(pos_id)可以虚拟一个固定值。

若您的系统有门店但没有终端概念，或门店下不存在多终端，终端号(pos_id)可以传与门店号(store_id)相同的值，或一个固定值。

在同一个翼码商户号下
1. 门店号(store_id)+终端号(pos_id)的组合已绑定成功过，接口会直接返回成功，不会修改门店信息；
2. 门店号(store_id)与门店名称(store_name)一一对应，不同门店号不允许传相同的门店名称；
3. 门店号(store_id)已绑定成功过，更换终端号(pos_id)再次绑定，会在已存在的门店下新增一个终端。

如需修改门店信息调用【4.30.门店信息修改】接口。

交易请求报文

JSON:

{
    "request_type": "bind_pos_request",
    "isspid": "39493002",
    "pos_id": "1511300001",
    "pos_seq": "1511300000001",
    "user_id": "user01",
    "system_id": "8888",
    "store_info": {
        "store_id": "1511300001",
        "store_name": "门店名称",
        "store_addr": "门店地址",
        "contact": "门店联系人",
        "contact_tel": "13900000000",
        "contact_email": "11@qq.com",
        "province": "福建",
        "city": "福州",
        "town": "鼓楼"
    },
    "pay_params": {
        "wxapp": {
            "tunnel": "0",
            "mch_id": "1612345678",
            "appid": "wx01oikjdnp4mws59c"
        }
    },
    "sign": "B973E02223C49798CDCBCEE48FC323EF"
}

XML:

<?xml version="1.0" encoding="GBK"?>
    <business_trans>
    <request_type>bind_pos_request</request_type>
    <isspid>39493002</isspid>
    <pos_id>1511300001</pos_id>
    <pos_seq>1511300000001</pos_seq>
    <user_id>user01</user_id>
    <system_id>8888</system_id>
    <store_info>
        <store_id>1511300001</store_id>
        <store_name>门店名称</store_name>
        <store_addr>门店地址</store_addr>
        <contact>门店联系人</contact>
        <contact_tel>13900000000</contact_tel>
        <contact_email>11@qq.com</contact_email>
        <province>福建</province>
        <city>福州</city>
        <town>鼓楼</town>
    </store_info>
    <pay_params>
        <wxapp>
            <tunnel>0</tunnel>
            <mch_id>1612345678</mch_id>
            <appid>wx01oikjdnp4mws59c</appid>
        </wxapp>
    </pay_params>
</business_trans>

交易请求报文说明

pay_params 收款账号信息 (JSONObject)

wxapp 微信小程序收款账号信息 (JSONObject)

交易返回报文

JSON:

{
    "response_type": "bind_pos_response",
    "isspid": "39493002",
    "pos_id": "123456789",
    "pos_seq": "000000000001",
    "trans_time": "20181214113740",
    "result": {
        "id": "0000",
        "comment": "操作成功"
    },
    "sign": "EADFE430D0E856CF5F818690155F1258"
}

XML:

<?xml version="1.0" encoding="GBK"?>
<business_trans>
    <response_type>bind_pos_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>
    <result>
        <id>0000</id>
        <comment>成功</comment>
    </result>
</business_trans>

交易返回报文说明

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

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