接口介绍
本接口用于第三方查询商户签约详情
参数简介
参数名 |
参数类型 |
参数介绍 |
是否必填 |
是否参与签名 |
command |
String(32) |
接口名,用于标识调用哪个接口,取值为:open.merchant.sign.query |
是 |
是 |
app |
String(32) |
接入商标识 |
是 |
是 |
out_merchant_code |
String(32) |
第三方商户号(第三方商户号和采宝商户号至少填一个) |
否 |
是 |
merchant_code |
String(32) |
采宝商户号(第三方商户号和采宝商户号至少填一个) |
否 |
是 |
channel |
String(16) |
签约渠道:MYBANK(网商银行) |
是 |
是 |
sign |
String(32) |
签名, 参见:请求签名规则 |
是 |
否 |
图片类型详解
状态值 |
解释 |
ID_CARD_FRONT |
身份证正面(头像面) |
ID_CARD_BACK |
身份证反面(国徽面) |
ORGANIZATION_CERTIFICATE |
组织机构代码证 |
BUSINESS_LICENSE |
营业执照 |
BUSINESS_PLACE_DOOR_HEAD |
经营场所门头照 |
BUSINESS_PLACE_INTERIOR |
经营场所内景照 |
HAND_HOLD_ID_CARD |
手持身份证 |
返回值说明
参数名 |
所属结构 |
返回值类型 |
返回值说明 |
特殊备注 |
success |
result |
boolean |
标识这次请求是否成功 |
|
errorCode |
result |
String |
错误码 |
|
errorMsg |
result |
String |
错误码的详细说明 |
|
company_type |
data.sign_detail |
String(32) |
商户类型 |
|
sign_channel |
data.sign_detail |
String(32) |
签约渠道 |
|
sign_channel_name |
data.sign_detail |
String(32) |
签约渠道名称 |
|
open_account_name |
data.sign_detail |
String(32) |
开户名称 |
|
open_account_bank |
data.sign_detail |
String(32) |
开户银行 |
|
bank_account_number |
data.sign_detail |
String(32) |
银行账号 |
|
merchant_rate |
data.sign_detail |
int |
签约费率 |
|
merchant_name |
data.sign_detail.business_info(经营信息) |
String(32) |
商户全称 |
|
merchant_code |
data.sign_detail.business_info(经营信息) |
String(32) |
采宝商户号 |
|
out_merchant_code |
data.sign_detail.business_info(经营信息) |
String(32) |
第三方商户号 |
|
abbreviation |
data.sign_detail.business_info(经营信息) |
String(32) |
商户简称 |
|
trade |
data.sign_detail.business_info(经营信息) |
String(32) |
行业类目 |
|
business_address |
data.sign_detail.business_info(经营信息) |
String(32) |
经营地址 |
|
service_telephone |
data.sign_detail.business_info(经营信息) |
String(32) |
客服电话 |
|
name |
data.sign_detail.contact(日常联系人) |
String(32) |
姓名 |
|
position |
data.sign_detail.contact(日常联系人) |
String(32) |
职务 |
|
phone |
data.sign_detail.contact(日常联系人) |
String(32) |
手机 |
|
email |
data.sign_detail.contact(日常联系人) |
String(32) |
邮箱 |
|
certificate_number |
data.sign_detail.organization_info(组织机构代码证) |
String(32) |
证件编号 |
|
begin_time |
data.sign_detail.organization_info(组织机构代码证) |
long |
有效期开始时间戳 |
|
end_time |
data.sign_detail.organization_info(组织机构代码证) |
long |
有效期结束时间戳 |
|
name |
data.sign_detail.legal_person(法人代表) |
String(32) |
姓名 |
|
certificate_type_name |
data.sign_detail.legal_person(法人代表) |
String(32) |
证件类型 |
|
certificate_type_number |
data.sign_detail.legal_person(法人代表) |
String(32) |
法人证件编号 |
|
begin_time |
data.sign_detail.legal_person(法人代表) |
long |
有效期开始时间戳 |
|
end_time |
data.sign_detail.legal_person(法人代表) |
long |
有效期结束时间戳 |
|
image_type |
data.sign_detail.images(图片) |
String(32) |
图片类型 |
|
image_name |
data.sign_detail.images(图片) |
String(32) |
图片名称 |
|
image_url |
data.sign_detail.images(图片) |
String(256) |
图片路径 |
|
timestamp |
data |
long |
时间戳 |
参与签名 |
sign |
data |
String(32) |
签名值 |
参见:接口返回值的安全校验规则 |
返回值举例
{
"result":{
"success":true,
"errorCode":"10",
"errorMsg":"command参数为空"
},
"data":{
"sign_detail":{
"company_type":"",##商户类型
"sign_channel":"",##签约渠道
"sign_channel_name":"",##签约渠道名称
"open_account_name":"",##开户名称
"open_account_bank":"",##开户银行
"bank_account_number":"",##银行账号
"merchant_rate":0,##签约费率
"business_info":{//经营信息
"merchant_name":"",##商户全称
"merchant_code":"",##采宝商户号
"out_merchant_code":"",##第三方商户号,
"abbreviation":"",##商户简称
"trade":"",##行业类目
"business_address":"",##经营地址
"service_telephone":""##客服电话
},
"contact":{//日常联系人
"name":"",##姓名
"position":"",##职务
"phone":"",##手机
"email":""##邮箱
},
"organization_info":{//组织机构代码证
"certificate_number":"",##证件编号
"begin_time":0,##有效期开始时间戳
"end_time":0##有效期结束时间戳
},
"legal_person":{//法人代表
"name":"",##姓名
"certificate_type_name":"",##证件类型
"certificate_type_number":"",##法人证件编号
"begin_time":0,##有效期开始时间戳
"end_time":0##有效期结束时间戳
},
"images":[//图片
{
"image_type":"",##图片类型
"image_name":"",##图片名称
"image_url":""##图片路径
},
......
]
},
"timestamp":"",##时间戳,参与签名
"sign":""##签名
}
}
js demo
https://openapi.caibaopay.com/test/api/querySignInfo.htm