iot设备绑定门店接口 -凯发app官方网站

支持第三方代理调用

更新时间：2023-11-17 10:39:12

订阅更新

我的文档

设置

通用场景

同步iot设备、商户和门店的绑定关系

公共请求参数

参数	类型	是否必选	最大长度	描述	示例值
app_id	string	必选	32	支付宝分配给开发者的应用id	2014072300007148
method	string	必选	128	接口名称	alipay.merchant.iot.device.bind
format	string	可选	40	仅支持json	json
charset	string	必选	10	请求使用的编码格式，如utf-8,gbk,gb2312等	utf-8
sign_type	string	必选	10	商户生成签名字符串所使用的签名算法类型，目前支持rsa2和rsa，推荐使用rsa2	rsa2
sign	string	必选	344	商户请求参数的签名串，详见签名	详见示例
timestamp	string	必选	19	发送请求的时间，格式"yyyy-mm-dd hh:mm:ss"	2014-07-24 03:07:50
version	string	必选	3	调用的接口版本，固定为：1.0	1.0
app_auth_token	string	可选	40	详见应用授权概述
biz_content	string	必选		请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

业务请求参数

device_id_type必选string(32)

【描述】可选方式。枚举支持：
* id：表示使用 biztid 作为设备唯一识别标识，
* sn：表示使用 supplier_id、device_sn联合作为设备唯一识别标识。
注意：由于不同机型的supplier_id不同，推荐使用 id 。

【示例值】sn

merchant_type必选string(32)

【描述】商户类型。枚举支持：
* direct：直连商户；
* indirect：间连商户。

【示例值】indirect

pid必选string(64)

【描述】直连场景填写商户收单pid。间连场景填写smid绑定的pid（可通过代运营授权api获取）。

【示例值】2088101112139885

shop_id必选string(64)

【描述】商户pid名下的门店 id。可通过门店管理api获取，需注意请勿使用smid创建门店 id。

【示例值】2020081700502012300038796029

biz_tid特殊可选string(128)

【描述】设备 id ，仅device_id_type 为 id 时填写。

【示例值】01017gv1cz1xxasnbqktjqchletnyvxtsky1pas4fkz6tjrmqymg2zk

supplier_id特殊可选string(128)

【描述】设备供应商id ，device_id_type 为 sn 时填写。需注意不同机型的供应商id可能不同。

【示例值】201812271300540049

device_sn特殊可选string(128)

【描述】设备序列号，device_id_type 为 sn 时填写。需配合supplier_id使用。

【示例值】qcf420190316000107

smid特殊可选string(64)

【描述】直连场景不填，间连场景填写商户收单smid

【示例值】2088101112139886

参数	类型	是否必选	最大长度	描述	示例值
device_id_type	string	必选	32	可选方式。枚举支持： * id：表示使用 biztid 作为设备唯一识别标识， * sn：表示使用 supplier_id、device_sn联合作为设备唯一识别标识。注意：由于不同机型的supplier_id不同，推荐使用 id 。	sn
biz_tid	string	特殊可选	128	设备 id ，仅device_id_type 为 id 时填写。	01017gv1cz1xxasnbqktjqchletnyvxtsky1pas4fkz6tjrmqymg2zk
supplier_id	string	特殊可选	128	设备供应商id ，device_id_type 为 sn 时填写。需注意不同机型的供应商id可能不同。	201812271300540049
device_sn	string	特殊可选	128	设备序列号，device_id_type 为 sn 时填写。需配合supplier_id使用。	qcf420190316000107
merchant_type	string	必选	32	商户类型。枚举支持： * direct：直连商户； * indirect：间连商户。	indirect
pid	string	必选	64	直连场景填写商户收单pid。间连场景填写smid绑定的pid（可通过代运营授权api获取）。	2088101112139885
smid	string	特殊可选	64	直连场景不填，间连场景填写商户收单smid	2088101112139886
shop_id	string	必选	64	商户pid名下的门店 id。可通过门店管理api获取，需注意请勿使用smid创建门店 id。	2020081700502012300038796029

常见请求示例

默认示例

javac#phphttp

alipayclient alipayclient = new defaultalipayclient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","gbk","alipay_public_key","rsa2");
alipaymerchantiotdevicebindrequest request = new alipaymerchantiotdevicebindrequest();
request.setbizcontent("{" 
"\"device_id_type\":\"sn\"," 
"\"biz_tid\":\"01017gv1cz1xxasnbqktjqchletnyvxtsky1pas4fkz6tjrmqymg2zk\"," 
"\"supplier_id\":\"201812271300540049\"," 
"\"device_sn\":\"qcf420190316000107\"," 
"\"merchant_type\":\"indirect\"," 
"\"pid\":\"2088101112139885\"," 
"\"smid\":\"2088101112139886\"," 
"\"shop_id\":\"2020081700502012300038796029\"" 
"  }");
alipaymerchantiotdevicebindresponse response = alipayclient.execute(request);
if(response.issuccess()){
system.out.println("调用成功");
} else {
system.out.println("调用失败");
}

说明：本示例仅供参考。

公共响应参数

参数	类型	是否必选	最大长度	描述	示例值
code	string	必选	-	网关返回码,	40004
msg	string	必选	-	网关返回码描述,	business failed
sub_code	string	可选	-	业务返回码，参见具体的api接口文档	acq.trade_has_success
sub_msg	string	可选	-	业务返回码描述，参见具体的api接口文档	交易已被支付
sign	string	必选	-	签名,	dzxh8eetuahoye3w1j poiphfdxoybfunn1lket/v7p4zjdyojwea6izs6hz0ydw5cp/viufub5i0/v5wens3oyr8zredqo6d futdlhdc efyckiqhbxizgngpdpdfp1pis7bdhhzrszhbrqb7o4k3dxc aanfauu4v6zdwczo=

业务响应参数

无业务响应参数

响应示例

正常示例

异常示例

{
    "alipay_merchant_iot_device_bind_response": {
        "code": "10000",
        "msg": "success"
    },
    "sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}