接口介绍
本接口用于第三方查询商户签约详情
参数简介
公共参数
| 参数名 | 参数类型 | 参数介绍 | 是否必填 |
|---|
| 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(网商银行) | 是 |
返回值说明
公共返回值
| 参数名 | 所属结构 | 返回值类型 | 返回值说明 | 特殊备注 |
|---|
| 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.qiantupay.net/test/api/v2/querySign.htm