iPos接口接入报文规范

业务说明交易请求报文交易请求报文说明交易返回报文交易返回报文说明业务说明商户系统调用本接口，将商户系统的门店和终端信息传给翼码，在翼码系统生成出对应门店和终端。

门店号(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": "鼓楼" }, "sign": "B973E02223C49798CDCBCEE48FC323EF"}XML:

bind_pos_request 39493002 1511300001 1511300000001 user01 8888 1511300001 门店名称 门店地址 门店联系人 13900000000 11@qq.com 福建 福州 鼓楼 交易请求报文说明节点名称中文名称类型说明是否必填sign报文签名String(32)请求报文格式为JSON时必填计算签名方式请看2.1章节可选request_type请求类型String(32)固定值：bind_pos_request必填system_id系统平台号String(4)由翼码提供必填isspid商户号String(8)翼码商户号，由翼码提供必填pos_id终端号String(20)商户自定义终端号必填pos_seq终端流水号String(32)该接口流水号可选填，便于日志定位可空user_id操作员标识String(20)操作员编号可空store_info->store_id门店编号String(20)商户自定义门店号必填store_info->store_name门店名称String(100)门店名称（50个中文）必填store_info->store_addr门店地址String(100)门店地址必填，否则影响终端报备格式：省-市-区-详细地址长度仅支持50位，半角符号、英文、数字都算作1位省市区名称详见文档：20200721行政区划.xlsx直辖市省一级取值为“XX市”其余情况按文档中的“中文名称”填写正确示例：上海市-上海市-浦东新区-五星路101号5楼福建省-福州市-鼓楼区-软件园A区新疆维吾尔自治区-乌鲁木齐市-沙依巴克区-奇台路658号万达广场必填store_info->contact门店联系人String(32)门店联系人可空store_info->contact_tel门店联系电话String(32)门店联系电话可空store_info->contact_email门店联系邮箱String(64)门店联系邮箱可空store_info->province门店省份String(32)门店省份可空store_info->city门店城市String(32)门店城市可空store_info->town门店城镇String(32)门店城镇可空交易返回报文JSON:

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

bind_pos_response 39493002 123456789 000000000001 000000000244 20090405010104 0000 成功 交易返回报文说明标准接口会因业务升级需要而新增节点，请在解析返回报文时避免新增未知节点产生的程序出错！

节点名称中文名称类型说明是否必填sign报文签名String(32)返回报文格式为JSON时必填计算签名方式请看2.1章节可选response_type返回类型String(32)固定值：bind_pos_response必填isspid商户号String(8)翼码商户号，由翼码提供必填pos_id终端号String(20)商户自定义终端号必填pos_seq终端流水号String(32)终端交易流水号和请求报文的交易流水相同可选trans_time接口返回时间String(14)接口返回时间，格式：yyyyMMddHHmmss必填result->id响应码String(4)翼码平台返回的处理结果,0000-成功，其它失败，错误信息说明见“响应码解释”字段必填result->comment响应码解释String(64)响应码对应中文注解，用于显示提示必填标准接口会因业务升级需要而新增节点，请在解析返回报文时避免新增未知节点产生的程序出错！

附件20200721行政区划.xlsx