接口介绍
本接口用于第三方创建商户
参数简介
| 参数名 |
参数类型 |
参数介绍 |
是否必填 |
是否参与签名 |
| command |
String(32) |
接口名，用于标识调用哪个接口，取值为：open.merchant.create |
是 |
是 |
| app |
String(32) |
接入商标识 |
是 |
是 |
| merchant_code |
String(32) |
商户号 |
否 |
是 |
| user_phone |
String(16) |
商户手机号 |
是 |
是 |
| identity_type |
String(32) |
对接方唯一标示，默认USER_PHONE，可选USER_PHONE(手机号),SYSTEM_ID(系统ID) |
否 |
是 |
| merchant_name |
String(32) |
商户名称 |
是 |
是 |
| abbreviation |
String(32) |
商户简称 |
是 |
是 |
| province |
String(16) |
省名称 (/省/市/区/县名称对照表) |
是 |
是 |
| city |
String(16) |
市名称 (/省/市/区/县名称对照表) |
是 |
是 |
| area |
String(16) |
区名称 (/省/市/区/县名称对照表) |
是 |
是 |
| sign_notify_url |
String(256) |
签约结果回调地址 |
是 |
是 |
| sign |
String(32) |
签名, 参见：请求签名规则 |
是 |
否 |
返回值说明
| 参数名 |
所属结构 |
返回值类型 |
返回值说明 |
特殊备注 |
| success |
result |
boolean |
标识这次请求是否成功 |
|
| errorCode |
result |
String |
错误码 |
|
| errorMsg |
result |
String |
错误码的详细说明 |
|
| gateway_url |
data |
String(256) |
授权网关地址 |
参与签名 |
| merchant_qr_code |
data |
String(256) |
商户二维码地址 |
参与签名 |
| merchant_code |
data |
String(32) |
该商户的采宝商户号 |
参与签名 |
| store_id |
data |
String(32) |
默认门店ID |
参与签名 |
| operator_id |
data |
String(32) |
默认收银员ID |
参与签名 |
| timestamp |
data |
long |
时间戳 |
参与签名 |
| sign |
data |
String(32) |
签名值 |
参见：接口返回值的安全校验规则 |
返回值举例
{
"result": {
"success": false,
"errorCode":"10",
"errorMsg": "command参数为空"
},
"data":{
"gateway_url":"", ##授权网关地址
"merchant_qr_code":"",##商户二维码地址
"merchant_code":"",##该商户的采宝商户号
"store_id":"",##默认门店ID
"operator_id":"",##默认收银员ID
"timestamp":"", ## 时间戳，参与签名
"sign":"" ## 签名值
}
}
js demo
https://openapi.caibaopay.com/test/api/createMerchant.htm