menu

商户管理接口

更新时间: 2019-12-24 18:10:38 · 编辑者:宇链科技

提供商户管理能力。

宇链区块链可信云中的商户分为 子商户(subMerchant)和父商户(merchant)。通常来讲,子商户更为常用,父商户更多用于多个商户统一管理及继承相同的支付参数。

商户登录

接口地址:

POST /merchant/login

POST 内容请使用 JSON(请使用 Content-Type: application/json 头)。该接口同时适用于子商户和父商户。

body 例子及解释:

{
    "userId": "要登录的商户号或者子商户号",
    "pw": "登录密码" // 务必在 SSL 安全连接中传输
}

返回值例子及解释:

{
    "status": "success",
    "version": 1,
    "displayName": "小黄烧卖",
    "userId": "SM4503274928",
    "loginToken": "74df73266683417fdd58e6272ff921be",
    "parentMerchantId": "PM8687779009"
}

当登录失败:

{
    "status": "fail",
    "version": 1,
    "error": "xxxx",
    "msg": "xxxx"
}

需要记录在本地的是 loginToken,也就是登陆密钥。当前,token 没有过期时间,但是在未来可能会有。因此,在做一些需要登录才可以进行的接口调用时,需要判断是否返回 401 错误,不能假设登录永久有效。

创建商户

该接口同时适用于子商户和父商户。

宇链云上的商户分为父商户和子商户两层。实际业务逻辑都发生在子商户,父商户主要用于统一收银、统一查询、统一设置参数等。任何一个子商户都要归属于一个父商户,即使只有一个子商户,也要创建一个对应的父商户,再创建子商户。

接口地址:

POST /merchant

POST 内容请使用 JSON(请使用 Content-Type: application/json 头)。

创建商户的例子:

{
        "type": "subMerchant",  // 创建子商户(subMerchant)还是父商户(merchant)
        "parameters": {
            "displayName": "Test",      // 商户显示名称
            "pw": "123456",             // 商户密码
            "disabled": false,          // 是否禁用该商户
            "appId": "xxx",             // 该商户所属的 appId。该 `appId` 可以和签名用的 `appId` 不同,一旦设置无法修改,未来该 `appId` 拥有修改该 `merchant` 各类信息的权限
            "parentMerchantId": "xx"    // (仅创建子商户时传递)该商户所属的父商户
        }
}

返回值例子:

{
    "status": "success",
    "version": 1,
    "data": {
        "id": "SMXXXXXXXXX" // 商户号(SM 为子商户,PM 为父商户)
    }
}