接口介绍
本接口用于第三方查询商户签约详情
参数简介
公共参数
参数名 |
参数类型 |
参数介绍 |
是否必填 |
command |
String(32) |
接口名,固定为:open.api.sign.query |
是 |
app |
String(32) |
接入商标识 |
是 |
version |
String(16) |
调用的接口版本,固定为:2.0 |
是 |
sign_type |
String(32) |
签名类型 MD5、RSA,默认MD5 |
否 |
request_id |
String(64) |
请求报文ID,唯一定位一次报文请求,由发起方生成,应答方原样返回,uuid生成,全局唯一 |
是 |
request_time |
String(32) |
请求发起时间,格式:yyyyMMddHHmmss,请求发起时间,应答方原样返回 |
是 |
sign |
String(32) |
签名,详见MD5签名、RSA256签名 |
是 |
参数简介
参数名 |
参数类型 |
参数介绍 |
是否必填 |
merchant_code |
String(32) |
第三方商户号(第三方商户号和采宝商户号至少填一个) |
否 |
cb_merchant_code |
String(32) |
采宝商户号(第三方商户号和采宝商户号至少填一个) |
否 |
channel |
String(16) |
签约渠道:MYBANK(银行通道);WECHAT(微信官方) |
是 |
返回值说明
公共返回值
参数名 |
所属结构 |
返回值类型 |
返回值说明 |
特殊备注 |
success |
result |
boolean |
标识这次请求是否成功 |
|
error_code |
result |
String(64) |
错误码 |
|
error_msg |
result |
String(16) |
错误码的详细说明 |
|
request_id |
data |
String(64) |
请求报文ID |
|
request_time |
data |
String(32) |
请求发起时间,格式:yyyyMMddHHmmss |
|
response_time |
data |
String(32) |
请求返回时间,格式:yyyyMMddHHmmss |
|
sign |
sign |
String |
签名值 |
具体参照: 接口验签规则 |
返回值说明
参数名 |
所属结构 |
返回值类型 |
返回值说明 |
特殊备注 |
merchant_name |
data |
String(32) |
商户全称 |
|
cb_merchant_code |
data |
String(32) |
采宝商户号 |
|
merchant_code |
data |
String(32) |
第三方商户号 |
|
abbreviation |
data |
String(32) |
商户简称 |
|
trade |
data |
String(32) |
行业类目 |
|
business_address |
data |
String(32) |
经营地址 |
|
service_telephone |
data |
String(32) |
客服电话 |
|
company_type |
data |
String(32) |
商户类型 |
|
sign_channel |
data |
String(32) |
签约渠道, 具体取值请参照:名词解释 |
|
sign_channel_name |
data |
String(32) |
签约渠道名称 |
|
sign_status |
data |
String(32) |
签约状态, 具体取值请参照:名词解释 |
|
reject_reason |
data |
String(32) |
驳回原因 |
|
sign_apply_time |
data |
String(32) |
签约申请时间 格式:yyyy-MM-dd HH:mm:ss |
|
sign_time |
data |
String(32) |
签约成功时间 格式:yyyy-MM-dd HH:mm:ss |
|
contact_info |
data |
Base64(32) |
联系人信息 |
|
settlement_info |
data |
Base64(32) |
结算信息 |
|
organization_license |
data |
Base64(32) |
组织机构代码证 |
|
business_license |
data |
Base64(32) |
营业执照 |
|
id_card_license |
data |
Base64(32) |
法人代表 |
|
images |
data |
Base64(32) |
经营场所照片、证件影印件 |
参数名 |
参数类型 |
参数介绍 |
是否必填 |
email |
String(50) |
邮箱 |
是 |
name |
String(50) |
姓名 |
是 |
phone |
String(50) |
电话 |
是 |
position |
String(50) |
职位 |
否 |
wechat_id |
String(50) |
微信号 |
否 |
示例
{"email":"test@test.com","name":"联系人姓名","phone":"电话","position":"职位"}
settlement_info 结算信息JSON组成
参数名 |
参数类型 |
参数介绍 |
是否必填 |
bank_account_type |
String(50) |
结算类型(PERSON,COMPANY),默认对私(PERSON) |
否 |
bank_account_number |
String(50) |
银行卡卡号 |
是 |
bank_contact_line |
String(50) |
银行联行号 |
对公结算时必填,附录 银行联行号 |
bank_reserved_mobile |
String(50) |
银行预留手机号 |
是 |
open_account_bank |
String(50) |
开户银行 |
是 |
branch_bank_name |
String(50) |
开户支行 |
是 |
open_account_name |
String(50) |
开户名称 |
是 |
merchant_rate |
Decimal(4, 2) |
签约费率 |
是 |
示例
{
"bank_account_number": "6214855113079652",
"bank_contact_line": "102331005384",
"bank_reserved_mobile": "18158102600",
"branch_bank_name": "中国工商银行股份有限公司杭州东湖支行",
"open_account_bank": "招商银行",
"open_account_name": "王五"
}
organization_license 组织结构代码证JSON组成
参数名 |
参数类型 |
参数介绍 |
是否必填 |
license_name |
String(50) |
机构名称 |
是 |
license_number |
String(50) |
机构编码 |
是 |
begin_time |
String(50) |
开始有效时间 |
否 |
end_time |
String(50) |
结束有效时间 |
否 |
示例
{
"license_name": "杭州XX信息科技有限公司",
"license_number": "410182600085602",
"begin_time": "2015-03-10 00:00:00",
"end_time": "2025-03-10 00:00:00"
}
business_license 营业执照JSON组成
参数名 |
参数类型 |
参数介绍 |
是否必填 |
license_name |
String(50) |
机构名称 |
是 |
license_number |
String(50) |
机构编码 |
是 |
begin_time |
String(50) |
开始有效时间 |
否 |
end_time |
String(50) |
结束有效时间 |
否 |
示例
{
"license_name": "杭州XX信息科技有限公司",
"license_number": "410182600085602",
"begin_time": "2015-03-10 00:00:00",
"end_time": "2025-03-10 00:00:00"
}
id_card_license 身份证JSON组成
参数名 |
参数类型 |
参数介绍 |
是否必填 |
license_name |
String(50) |
机构名称 |
是 |
license_number |
String(50) |
机构编码 |
是 |
begin_time |
String(50) |
开始有效时间 |
否 |
end_time |
String(50) |
结束有效时间 |
否 |
示例
{
"license_name": "王五",
"license_number": "33068320000101123X",
"begin_time": "2019-01-01 00:00:00",
"end_time": "2039-01-01 00:00:00"
}
images 图片数组JSON组成
参数名 |
参数类型 |
参数介绍 |
是否必填 |
image_type |
String(50) |
图片类型, 具体取值请参照:名词解释 |
是 |
image_url |
String(255) |
图片地址 |
是 |
说明
images 图片说明
参数名 |
参数介绍 |
是否必填 |
ID_CARD_FRONT |
身份证正面(头像面) |
是 |
ID_CARD_BACK |
身份证反面(国徽面) |
是 |
ORGANIZATION_CERTIFICATE |
组织机构代码证 |
非三证合一的个体/企业必填 |
BUSINESS_LICENSE |
营业执照 |
个体/企业必填 |
BUSINESS_PLACE_DOOR_HEAD |
经营场所门头照 |
是 |
BUSINESS_PLACE_INTERIOR |
经营场所内景照 |
是 |
OPEN_ACCOUNT_LICENSE |
开户许可证 |
对公结算必填 |
HAND_HOLD_ID_CARD |
手持身份证 |
特定场景必填 |
BIG_PLATFORM_SETTLED |
主流餐饮平台入驻图 |
特定场景必填 |
示例
[{
"image_type": "ID_CARD_FRONT",
"image_url": "https://pic.caibaopay.com/open/upload/803297ad817f4bcfdcc6a39eb2ceb6d8.jpg"
}, {
"image_type": "ID_CARD_BACK",
"image_url": "https://pic.caibaopay.com/open/upload/924827317de777f9ae93955f00e01242.jpg"
}, {
"image_type": "ORGANIZATION_CERTIFICATE",
"image_url": "https://pic.caibaopay.com/open/upload/ad3e2e0d49895fe43121d46ad6725cee.jpg"
}, {
"image_type": "BUSINESS_LICENSE",
"image_url": "https://pic.caibaopay.com/open/upload/d83c5c29b940be883f9ddb3cbf183cb3.jpg"
}, {
"image_type": "BUSINESS_PLACE_DOOR_HEAD",
"image_url": "https://pic.caibaopay.com/open/upload/40785e6c08493ecaaa505d6fe2f8870c.jpg"
}, {
"image_type": "BUSINESS_PLACE_INTERIOR",
"image_url": "https://pic.caibaopay.com/open/upload/40785e6c08493ecaaa505d6fe2f8870c.jpg"
}, {
"image_type": "BUSINESS_PLACE_INTERIOR",
"image_url": "https://pic.caibaopay.com/open/upload/40785e6c08493ecaaa505d6fe2f8870c.jpg"
}, {
"image_type": "OPEN_ACCOUNT_LICENSE",
"image_url": "https://pic.caibaopay.com/open/upload/6e515d3b4d5eace27048629b37f0fcfa.jpg"
}, {
"image_type": "HAND_HOLD_ID_CARD",
"image_url": "https://pic.caibaopay.com/open/upload/cdff4273194d8946f191d34a5d09f54c.jpg"
}, {
"image_type": "BIG_PLATFORM_SETTLED",
"image_url": "https://pic.caibaopay.com/open/upload/dcb627eb1f00d2316715ad11dcbec95a.png"
}]
返回值举例
js demo
http://openapi.caibaopay.com/test/api/v2/querySign.htm