申请入驻
接口地址: {api_domain}/api/cis/v1/merchants/apply
请求方式: POST
签名:需要签名,参考统一签名说明
请求参数:
参数名称 | 参数 | 类型(长度) | 必传 | 参数说明 |
---|---|---|---|---|
客户代码 | client_id | String(32) | 客户代码与服务商编号二选一 | 由收钱吧提供 |
服务商编号 | vendor_sn | String(32) | 客户代码与服务商编号二选一 | 需先提供给收钱吧业务人员配置 |
推广者账号 | crm_promoter_account | String(32) | N | 1. 销售人员的疯狂收钱吧账户 2. 若未提供正确号,则使用服务商在疯狂收钱吧的账号 |
客户系统商户号 | client_merchant_sn | String(32) | Y | 1. 客户系统商户号,需在客户系统内唯一 2. 若申请被驳回,可使用同一商户号重新提交资料,资料提交后会覆盖原申请信息 |
联系人信息 | contact | object | Y | 指定联系人的信息 |
主体信息 | legal_entity | object | Y | 商家的营业执照/登记证书、经营者/法人的证件等信息 |
门店信息 | store | object | Y | 商户门店的入网材料 |
结算银行账户 | bank_account | object | Y | 商家提现收款的银行账户信息 |
request.contact(联系人信息):
参数名称 | 参数 | 类型(长度) | 必传 | 字段限制 | 描述 |
---|---|---|---|---|---|
姓名 | name | String(20) | Y | 2 至 20 个字符, 支持中文,不支持英文、数字、特殊符号、emoji |
联系人姓名 |
电话 | cellphone | String(11) | Y | 11 位数字 | 手机号码,11位数字; 用于接收微信支付的重要管理信息及日常操作验证码请填写有效并且可以拨通的电话号码 |
联系人邮箱 | contact_email | String(32) | N | 需要带@,遵循邮箱格式校验 | 用于接收微信支付的开户邮件及日常业务通知; 微信直联必填,间联选填 |
联系人类型 | contact_type | String(10) | N | 联系人类型: 1. 经营者/法人 2. 经办人. 营业执照类型非【无营业执照】时,必填 |
|
联系人证件类型 | contact_id_doc_type | String(10) | N | 联系人类型传经办人时必填 1:中国大陆居民-身份证; 2:其他国家或地区居民-护照; 3:中国香港居民-来往内地通行证; 4:中国澳门居民-来往内地通行证; 5:中国台湾居民-来往大陆通行证; 6:外国人居留证; 7:港澳居民证; 8:台湾居民证 |
|
联系人证件正面照 | id_front_photo | String(255) | N | 联系人类型传经办人时必填 | |
联系人证件反面照 | id_back_photo | String(255) | N | 联系人类型传经办人时必填; 若联系人证件类型为护照,则无需上传反面照 |
|
联系人证件有效期开始时间 | contact_period_begin | String(32) | N | 联系人类型传经办人时必填; 请按照示例值填写。结束时间大于开始时间。 示例值:2019-06-06 |
|
联系人证件有效期结束时间 | contact_period_end | String(32) | N | 联系人类型传经办人时必填; 请按照示例值填写,若证件有效期为长期,请填写:长期。 结束时间大于开始时间,联系人证件有效期时间需大于60 天. 示例值:2026-06-06 |
|
联系人证件号 | id_number | String(32) | N | 联系人类型传经办人时必填; 可传身份证、来往内地通行证、来往大陆通行证、护照等证件号码。 |
|
业务办理授权函 | business_authorization_letter | String(255) | N | 当联系人类型传经办人,且微信直联时必填,间联无需填写; 请参照示例图 打印业务办理授权函,全部信息需打印,不支持手写商户信息,并加盖公章。 可上传 1 张图片,请填写通过图片上传API预先上传图片生成好的MediaID。 |
request.legal_entity(主体信息):
参数名称 | 参数 | 类型(长度) | 必传 | 字段限制 | 描述 |
---|---|---|---|---|---|
主体类型 | type | String | Y | 请根据主体类型填写以下代码。 0: 无营业执照; 1:个体工商户; 2:企业; 3:事业单位; 4:民办非企业单位; 5:社会团体; 6:基金会 |
|
行业信息 | industry | String(32) | N | 参考《收钱吧行业编码表》,提供行业编码. 例:自动售货机行业,传:002028 若未传正确的行业编码,则将按照配置的默认行业入网 |
|
行业许可证 | trade_license | String(255) | N | jpg、jpeg,图片大小不超过 2M | jpg、jpeg,图片大小不超过 2M; 上送的许可证内容详见《收钱吧行业编码表》 |
行业许可证类型ID | trade_license_type | Int(11) | N | 类型 id 信息,填写了“行业许可证”字段必填该字段。 值详见《收钱吧行业编码表》 |
|
证照图片 | entity_photo | String(255) | 条件选填 | jpg、jpeg、图片,大小不超过2M | 1、无营业执照不填,其他主体类型必填; 2、主体为个体户工商/企业,请上传营业执照,需年检章齐全,当年注册除外; 3、事业单位,请上传事业单位法人证书、统一社会信用代码证书; 4、民办非企业单位/社会团体/基金会,请上传社会团体法人登记证书、民办非企业单位登记证书、基金会法人登记证书 |
单位授权函 | certificate_letter_photo | String(255) | 条件选填 | jpg、jpeg、图片,大小不超过2M | 1、事业单位必填,其他主体类型选填; 2、请参照示例图打印单位证明函,全部信息需打印,不支持手写商户信息,并加盖公章 |
证照号码 | entity_number | String(18) | 条件选填 | 1.个体工商户营业执照:15 位或18 位,支持数字、大写字母; 2、其他证照:18位,支持数字或大写字母; |
1、上传证照图片必填; 2、营业执照,请填写营业执照注册号; 3、证书,请填写证书号码 |
证照主体名称 | entity_name | String(128) | 条件选填 | 2 至 50 个字符,支持中英文、中英文括号、《》- | 1、上传证照图片必填; 2、营业执照上的商户名称, 3、个体户,不能以“公司”结尾,若营业执照上商户名称为“空“或“无”时,填写"个体+经营者姓名",如“个体张三” 4、证书,登记证书上的商户名称 |
主体简称 | entity_shortname | String(40) | Y | 2至 40 个字符,支持中英文、数字、中英文()、《》、-,至少包含 1 个中文、不支持其他特殊符号、emoji | 1. 在支付完成页向买家展示; 2. 商户经营名称 |
证照注册地址 | entity_address | String(128) | 条件选填 | 营业证照登记的注册地址,128个字符,支持中英文数字、字符,不支持emoji | 1、无营业执照,不填; 2、个体工商/企业/单位事业/民办非企业单位/社会团体/基金会,请填写证书的注册地址 |
证照有效日期开始时间 | entity_period_begin | String(32) | 条件选填 | 1、无营业执照,不填; 2、其他主体类型,请填写证照有效期。示例:2019-01-01 |
|
证照有效日期结束时间 | entity_period_end | String(32) | 条件选填 | 1、无营业执照不填/其他类型必填; 2、若证件有效期为长期,请填写:长期; 3、结束日期大于开始日期; 4、有效期必须大于 60天。 示例:2019-08-01,长期 |
|
经营者/法人证件 | representative | object | 条件选填 | 无营业执照选填,其他主体类型必填 |
request.legal_entity.representative(主体资料-经营者/法人身份证件):
参数名称 | 参数 | 类型(长度) | 必传 | 字段限制 | 描述 |
---|---|---|---|---|---|
证件类型 | id_type | String(32) | Y | 证件类型: 1:中国大陆身份证、 2:非中国护照、 3:台胞证、 4:港澳通行证 |
|
证件正面照片 | id_front_photo | String(255) | Y | jpg、jpeg,图片大小不超过 1M | 1、请上传证件人像页照片; 2、可上传 1 张图片,请填写通过图片上传接口预先上传图片生成好的 url |
证件背面照片 | id_back_photo | String(255) | 条件选填 | jpg、jpeg,图片大小不超过 1M | 1、身份证,请上传国徽面照片; 2、非中国护照,请上传入境盖章页; 3、台胞证、港澳通行证可不填写; 4、可上传 1 张图片,请填写通过图片上传接口预先上传图片生成好的 url |
证件姓名 | id_name | String(32) | Y | 1)身份证:2 至 40个字符,支持中文及【·】; 2)港澳台:2 至 40个字符,支持中文,或英文加空格; 3)非中华人民共和国护照:2 至 40 个字符,支持英文加空格; |
证件上的姓名 |
证件号码 | id_number | String(32) | Y | 1、身份证:18 位数字或 X; 2、港澳居民来往内地通行证:H 或 M 开头+8 位数字; 3、台湾居民来往大陆通行证:8 位数字; 4、非中华人民共和国护照:9 位数字或字母 |
证件上的号码 |
证件有效日期开始时间 | id_period_begin | String(32) | Y | 结束时间大于开始时间; 示例:2019-01-01 |
|
证件有效日期截止时间 | id_period_end | String(32) | Y | 1、必填,请按照示例值填写; 2、若证件有效期为长期,请填写:长期 3、结束时间大于开始时间; 4、证件有效期需大于60 天; 示例:2030-01-01、长期 |
request.store(主体资料-店铺信息):
参数名称 | 参数 | 类型(长度) | 必传 | 字段限制 | 描述 |
---|---|---|---|---|---|
门店名称 | store_name | String(40) | Y | 2 至 40 个字符,支持中英文数字,支持符号()()-·~_<>《》 不支持特殊符号、emoji |
|
客服电话 | service_phone | String(32) | Y | 5-20 位数字,支持固话、手机号 | 在交易记录中向买家展示,请确保电话畅通以便平台回拨确认 |
店铺地区编码 | address_code | String(32) | Y | 填写门店省市编码,只能由数字组成,详细参见省市对照表 | |
店铺地址 | address | String(128) | Y | 5 至128字符,支持中英文数字,至少包含一个中文,支持符号()()-、·~_<>《》|#;不支持特殊符号,emoji | 填写店铺详细地址,具体区/县及街道门牌号或大厦楼层 |
经度 | longitude | String(16) | N | 116.307490 | 不填写则会使用address 计算 |
纬度 | latitude | String(16) | N | 39.984154 | 不填写则会使用address 计算 |
门头照片 | store_photo | String(255) | 条件选填 | jpg、jpeg,图片大小不超过 2M | 1、提交门店门口照片,要求招牌清晰可见; 2、可上传 1 张图片,请填写通过图片上传接口预先上传图片生成好的 url |
室外环境照片 | outdoor_photos | [ String(255) ] | 条件选填 | jpg、jpeg,图片大小不超过 2M | 1、至少上传 1张门店外部环境照片,请填写通过图片上传接口预先上传图片生成好的 url |
室内环境照片 | indoor_photos | [ String(255) ] | 条件选填 | jpg、jpeg,图片大小不超过 2M | 1、门店内部环境照片; 2、至少上传 1张,请填写通过图片上传接口预先上传图片生成好的 url |
其他照片 | other_photos | [ String(255) ] | N | jpg、jpeg,图片大小不超过 2M | 1、特殊场景需要补充上传图片 |
经营场地证明 | address_certification | String(255) | N | jpg、jpeg,图片大小不超过 2M | 1、请上传门面租赁合同扫描件或经营场地证明(需与身份证同名) 2、至少上传 1张,请填写通过图片上传接口预先上传图片生成好的 url |
request.bank_account(结算银行账户):
参数名称 | 参数 | 类型(长度) | 必传 | 字段限制 | 描述 |
---|---|---|---|---|---|
账户类型 | account_type | enum | Y | 1:对私个人银行卡, 2:对公银行账户无营业执照/个体工商可结算至对私 |
|
开户名称 | account_name | String(128) | Y | 对私:2 至40 个字符,支持中文及【·】 对公:2 至50 个字符,支持中英文、数字、半角全角()- 《》,不支持特殊符号、emoji |
选择“对公银行账户”时,开户名称必须与营业执照上的“商户名称”一致 |
银行账号 | account_number | String(32) | Y | 1、对私:14至 19 位数字(不支持存折) 2、对公:7至 32 位数字 |
1、数字 |
开户银行名称 | bank_name | String(128) | Y | 开户银行全程可通过对私银行卡号或者关键词查询 | |
开户地区编码 | bank_address_code | String(32) | Y | 至少精确到市,详细参见省市区编号对照表 | |
开户支行全称 | branch_name | String(128) | Y | 开户支行全称,需通过开户银行名称和开户地区编码查询 | |
账户证明照片 | account_photo | String(255) | Y | JPG、JPEG格式,图片大小≤2MB | 1、对私个人银行卡:银行卡照片 2、对公银行账户:开户许可证/银行印鉴卡/银行回单(三选一) |
银行卡有效期 | card_validity_date | String(32) | N | 1、对私结算必填,示例:2030-10 2、对公银行账户不需要填写 |
|
结算人身份证信息 | account_holder | Object | 条件选填 | 1、无营业执照必填 2、若结算账户为非法人对私账户,则结算人身份证信息必填。 |
|
授权函 | auth_photo | String(255) | 条件选填 | 主体类型非无营业执照,且结算至非法人账户,则提供授权函。 | |
辅助证明材料 | hand_letter_of_authorization | [String(255)] | 条件选填 | JPG、JPEG格式,图片大小≤3MB | 1、最多提交三张照片,小于 3m 2、个体工商户非法人结算,如果授权委托书不能加盖公章,需要提供辅助证明: - 授权人与结算人关系证明(户口本、结婚证、出生证、房产证等证明授权人和结算人的亲属关系) - 提供授权人手持委托书和结算人的合照 - 被授权人与该商户门头的合影 |
request.bank_account.account_holder(结算账户-开户人证件信息)
参数名称 | 参数 | 类型(长度) | 必传 | 字段限制 | 参数说明 |
---|---|---|---|---|---|
身份证人像页照片 | id_front_photo | String(255) | Y | JPG/JPEG格式 大小≤1MB |
1. 上传身份证人像面照片 2. 可上传 1 张图片,请填写通过图片上传接口预先上传图片生成好的 url |
身份证国徽页照片 | id_back_photo | String(255) | Y | JPG/JPEG格式 大小≤1MB |
1. 上传身份证国徽面照片 2. 可上传 1 张图片,请填写通过图片上传接口预先上传图片生成好的 url |
身份证姓名 | id_name | String(32) | Y | 2-40个字符 支持中文及【·】 |
身份证姓名 |
身份证号码 | id_number | String(18) | Y | 身份证:18 位数字或 X | 身份证号码 |
身份证有效日期开始时间 | id_period_begin | String(32) | Y | 1、结束时间大于开始时间。 示例:2019-01-01 |
|
身份证有效日期截止时间 | id_period_end | String(32) | Y | 1、必填,请按照示例值填写。 2、若证件有效期为长期,请填写:长期。 3、结束时间大于开始时间。 4、证件有效期需大于 60天。 示例:2030-01-01、长期 |
响应参数:无业务响应参数,完整响应示例
提交成功响应示例
{
"response": {
"head": {
"version": "1.0.0",
"appid": "28lp61847655",
"sign_type": "SHA256",
"response_time": "2001-07-04T12:08:56+05:30",
"reserve": "{}"
},
"body": {
"result_code": "200",
"biz_response": {
"result_code": "SUCCESS"
}
}
},
"signature": "blmSaxUF6/N2XOcz7UWRRVQ5XsVCEz1BpZl6R9Rc6TA3+IfWhJtmCsUZjtw72w1QQ8rEV6+u
Mh3GWbyzH02Y9dJQCW=="
}