代理商通过该接口绑定商户终端设备信息。

接口说明

测试请求URL：https://test-api.huishouqian.com/merchant/register

生产请求URL：https://api.huishouqian.com/merchant/register

请求方式：POST

公共请求参数

变量 参数名 类型[长度限制] 必填 描述
method 方法名 string[1,32] 是 TERMINAL_DEVICE_QUERY
version 版本 string[1,16] 是 接口版本：2.0.0
format 请求格式 string[1,16] 是 业务请求参数格式，支持：JSON
agentMerchantNo 代理商商户号 string[1,16] 是 商户在慧收钱的代理商商户号，由慧收钱生成并下发
signType 加密类型 string[1,16] 是 RSA2:签名机制查看说明
signContent 加密数据 string 是 业务请求参数
sign 签名数据 string[1,128] 否 签名数据

业务请求参数

变量 参数名 类型[长度限制] 必填 描述
merchantNo 商户号 string[1,32] 是 慧收钱平台商户号
storeId 门店编号 string[1,32] 否 不传则按商户维度查询
deviceNo 设备序列号 string[1,50] 否 有值时按序列号精确筛选

公共请求示例

{method=TERMINAL_DEVICE_QUERY, format=json, signType=CFCA, signContent=7ecbad9cb113bd54e6ee45f7fe76883a40428d548b7294ce8f7ba30f211881073820d3ec7a54d3406dcf7a4d3f87f0994c24db54bab430777425147378dbf01afe0491a1c287e5ce380454b0e228a5a20d541874c14addd4100199660e6c4a857fa080ceb4601a0ee21e3fab9d87016198f151a3b16f60a254c1e8b4cd42cdf7, version=1.0, merchantNo=8000000026}

业务请求示例

{  
    "merchantNo":"891723857640"
}

公共响应参数

变量 参数名 类型[长度限制] 必填 描述
success 响应状态 string[1,32] 是 服务端响应状态，如果为true，则可以调用result；如果为false，则调用errorCode来获取出错信息
errorCode 错误码 string[1,32] 否 响应码
errorMsg 错误描述 string[1,128] 否 响应描述
result 响应内容 string 否 业务响应参数
sign 签名数据 string[1,128] 否 响应验签数据

业务响应参数

变量 参数名 类型[长度限制] 必填 描述
status 状态 string[1,16] 是 详见附录：交易状态码
respCode 结果码 string[1,16] 是 业务结果码，成功：000000
respMsg 结果信息 string[1,128] 是 业务结果描述
merchantNo 商户号 string[1,32] 是 慧收钱平台商户号
terminalList 终端列表 List 否 终端明细列表，无数据时可为空

终端明细列表

变量 参数名 类型[长度限制] 必填 描述
storeId 门店编号 string[1,32] 是 门店编号
deviceType 终端类型 string[1,32] 是 见终端类型枚举
deviceNo 设备序列号 string[1,50] 是 设备序列号
codeUrl 码牌URL string[1,256] 否

公共响应示例

{
"success":true,
"result":"88faca1f2511cc194367ffd96aa78a4cdf25a8284b0cd74b75e331b37c642b26aaeb46f2e4be38080eeb2b78575abd715d58fd30bbf59e167d64d0b714487f9462381e499a48524b1704694f256fa8f6e917d33cd413e365872ef2c7eede37ab4b23f67dcf6f34ec0daf65a34502123f792a646bea6447c126a612087825b17b91e585f74e56220328b198982e62a734387cd8556927e6881878b821969b6e784a20771cf55fad70a4368b8650c0ece0a7903678e1ad6134f6c711329a3e3e456c28ffbfc607fa6bf1f969a4d38b35ca3bf9ad81f71b2d2ad816502d579c0c4fc1f1fccec74a861c4679c5217be0176bf1eebcb57aea381f922fcf920aa471198be972f0c4f9fab10f7885b9c09eda977351b40e9058247ec30da55dd4c0be4a9de7d996e186e9f9ff2693f564f0eaddca9d7ff9f3b813d0c70bdba75b2a1bf9bd4ddf28ff66c45d6ce31e188d8606c82078d842008a9a1b4c1b64b7b2d3632087e46bbc4322181a9832cecd852682fdb72d336b32512bde94e81ba322fe9d2d",
"errorCode":null,
"errorMsg":null,
"sign":null
}

业务响应示例

终端设备类型

枚举值 描述
WIFI-SOUND WIFI码牌音响
TABLE-CODE 台码
SOUND 音响
POS POS机
QRGUN 扫码枪
11 辅助受理终端
10 条码支付受理终端
09 刷脸付终端
08 手机POS
04 智能POS
03 mPOS
02 传统POS

终端厂家类型

枚举值 描述
SANMUSEN 三木森（码牌音响）
XUNXIN 迅信（台码）
NEWLAND 新大陆
LIANDI 联迪

交易状态码

交易状态码 描述
INIT 初始化
PROCESSING 处理中
SUCCESS 成功
FAIL 失败
FINISHED 完成
作者：张杰  创建时间：2026-07-24 13:52
最后编辑：张杰  更新时间：2026-07-30 14:46