创建商家信息
- 商家号对应一个食堂供应商，通过传入商家名称获得对应的虚拟商家号，一个虚拟商家号可以生成多个不同的虚拟柜台号，设备通过绑定虚拟柜台号获取可以进行虚拟消费的能力（现金钱包支付、补贴钱包支付）。
- 在创建商家的同时传入由银行提供的商户编号merchantId，则返回的虚拟商家号拥有了小额免密代扣的属性，还需要针对商家柜台传入对应的商户柜台进行关联才能真正的做到小额免密代扣。
- 注：一个商家柜台号对应一台设备进行绑定，配置商户柜台号 的时候可以通过接口进行配置，也可以在银行的业务平台进行配置后一个商户柜台对应多个商家柜台
请求接口
openplt/jx/pj/scene/canteen/gy/createMerchant
公共参数
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| flowNo | 是 | String | 流水号 |
| campusId | 否 | String | 园区Id, 未传入时则取配置的园区Id |
| businessName | 是 | String | 商家名称 |
| merchantId | 否 | String | 商户编号,如果需要真实资金代扣，填写从商户网银申请下来的商户号 |
| posAmount | 是 | Number | 商家柜台数量，如果有需要一次性批量生成多个商家柜台号，则传入对应的数量，如果不需要在创建商家的同时创建商家柜台号，则传入“0”，如果不需要在该接口完成商户柜台绑定，则posIds可以不传 |
| posIds | 否 | String | 商户柜台号 如果需要真实资金代扣，填写从商户网银申请下来的柜台号，多个柜台号使用“,”区隔，柜台号数量需要与posAmount保持一致 |
| phoneNo | 否 | String | 商家手机号用于解绑时接收短信验证码 |
响应参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| result | 是 | String | 结果标志，Y 表示成功，N 表示失败 |
| errCode | 否 | String | 错误代码 |
| errMsg | 否 | String | 错误信息 |
| businessId | 是 | String | 商家编号 |
| posInfo | 是 | Array | 柜台实体信息 |
posInfo 列表
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| vPosId | 是 | String | 智慧食堂系统中为商家分配的虚拟柜台号 |
| posId | 否 | String | 客户向商户网银申请的柜台号，与vPosId一一对应 |
请求示例
{
"flowNo": "257237784639479747698254",
"campusId": "campusId_1dac56a3eea5",
"businessName": "商家名称",
"merchantId": "6635656721",
"posAmount": 1,
"posIds": "",
"phoneNo": ""
}
返回值示例
{
"result": "Y",
"errCode": null,
"errMsg": null,
"businessId": "SJ40c7a04d13a4",
"posInfo": [
{
"vPosId": "vPosId_10a0abc4053b",
"posId": null
}
]
}