服务商进件/信息变更/开通DO

简介:代理商进件/信息变更/开通DO

HOST:

联系人: zhangyl

Version:0.0.1

[TOC]

服务商（创建）

接口地址:/channel-app/api/agency/create

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

服务商（创建）

请求示例:

{
  "param": {
    "agencyInfo": {
      "agencyName": "二代服务商",
      "parentAgencyNo": "80000016",
      "topAgencyNo": "80000016",
      "level": 2,
      "businessType": "1",
      "contactName": "张三",
      "contactPhone": "13635309031",
      "contactEmail": "zhang@qq.com",
      "officeAddress": "望京soho",
      "provinceCode": "110000",
      "provinceName": "北京市",
      "cityCode": "110100",
      "cityName": "北京市",
      "enterpriseCode": "914403006610143472",
      "enterpriseName": "某某上市企业",
      "enterpriseAddress": "望京soho",
      "enterpriseCapital": "10000万",
      "enterpriseStart": "2024-08-01",
      "enterpriseEnd": "2028-08-31",
      "legalName": "张三",
      "legalIdCard": "152128198010141812",
      "legalPhone": "13635309031",
      "legalIdCardStart": "2024-08-01",
      "legalIdCardEnd": "2028-08-31",
      "signingName": "ice-run",
      "signingDate": "2024-08-01",
      "signingProtocolDate": "2024-08-01"
    },
    "agencySettle": {
      "settleType": "1",
      "name": "张三",
      "bankCard": "9558801001151625944",
      "idCard": "152128198010141812",
      "phone": "13635309031",
      "headBankNo": "C1010511003703",
      "headBankName": "中国建设银行",
      "branchBankNo": "105100001036",
      "branchBankName": "中国建设银行北京新华支行"
    },
    "agencyFileList": [{"fileType": "1","fileId": "202311061704534941"}]
  }
}

请求参数:

参数名称	参数说明	是否必须	数据类型
agencyInfo	服务商基本信息	true	object
agencySettle	服务商结算信息	true	object
agencyFileList	服务商图片文件信息	true	array

请求参数 agencyInfo:

参数名称	参数说明	是否必须	数据类型
agencyName	服务商名称	true	string
parentAgencyNo	上级服务商编号(非一级必填)	false	string
level	层级	true	integer(int32)
businessType	企业类型（1-企业，2-个人）	true	string
contactName	联系人	true	string
contactPhone	联系人电话	true	string
contactEmail	联系邮箱	true	string
officeAddress	办公地址	true	string
provinceCode	所属省份编码	true	string
provinceName	所属省份名称	true	string
cityCode	所属城市编码	true	string
cityName	所属城市名称	true	string
enterpriseCode	统一社会信用代码（企业必填）	false	string
enterpriseName	企业名称（企业必填）	false	string
enterpriseAddress	注册地址	true	string
enterpriseCapital	注册资本	false	string
enterpriseStart	营业执照有效期开始时间 (yyyy-mm-dd)（企业必填）	false	string
enterpriseEnd	营业执照有效期结束时间(yyyy-mm-dd 长期：9999-12-31)（企业必填）	false	string
legalName	法人名称	true	string
legalIdCard	法人身份证	true	string
legalPhone	法人手机号	true	string
legalIdCardStart	法人身份证有效期开始时间(yyyy-mm-dd)	true	string
legalIdCardEnd	法人身份证有效期结束时间(yyyy-mm-dd 长期：9999-12-31)	true	string
signingName	签约主体名称	false	string
signingDate	签约日期	false	string
signingProtocolDate	协议签署日期	false	string

请求参数 agencySettle:

参数名称	参数说明	是否必须	数据类型
settleType	结算类型（1-对公结算，2-对私法人结算）	true	string
name	结算账户名	true	string
bankCard	结算卡号	true	string
idCard	结算人身份证	false	string
phone	预留手机号	false	string
headBankNo	总行编码	true	string
headBankName	总行名称	true	string
branchBankNo	支行编码（联行号）	true	string
branchBankName	支行名称	true	string

请求参数 agencyFileList:

参数名称	参数说明	是否必须	数据类型
fileType	文件类型(参考下面类型描述)	true	string
fileId	文件编号(纯数字)	true	string

注意事项

fileType 1 企业营业执照
2 法人身份证正面
3 法人身份证反面
4 结算人身份证正面
5 结算人身份证反面
6 加强业务管理告知函
7 风险责任承诺函
8 服务商检查评估报告
9 银行卡收单业务拓展协议一
10 银行卡收单业务拓展协议二
11 银行卡收单业务拓展协议三
12 结算对象银行卡正面照片
企业必传图片：1、2、3；个人必传图片 2、3；如果结算账户为对私户需要传 12

响应状态:

状态码	说明
200	OK

响应参数:

参数名称	参数说明	类型
agencyNo	服务商编号	string

响应示例:

{
	"data": {
		"agencyNo": "80000016"
	}
}

服务商（修改）

接口地址:/channel-app/api/agency/update

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

服务商（修改）

请求示例:

{
  "param": {
    "agencyNo": "80000016",
    "agencyInfo": {
      "agencyName": "二代服务商",
      "parentAgencyNo": "80000016",
      "topAgencyNo": "80000016",
      "level": 2,
      "businessType": "1",
      "contactName": "张三",
      "contactPhone": "13635309031",
      "contactEmail": "zhang@qq.com",
      "officeAddress": "望京soho",
      "provinceCode": "110000",
      "provinceName": "北京市",
      "cityCode": "110100",
      "cityName": "北京市",
      "enterpriseCode": "914403006610143472",
      "enterpriseName": "某某上市企业",
      "enterpriseAddress": "望京soho",
      "enterpriseCapital": "10000万",
      "enterpriseStart": "2024-08-01",
      "enterpriseEnd": "2028-08-31",
      "legalName": "张三",
      "legalIdCard": "152128198010141812",
      "legalPhone": "13635309031",
      "legalIdCardStart": "2024-08-01",
      "legalIdCardEnd": "2028-08-31",
      "signingName": "ice-run",
      "signingDate": "2024-08-01",
      "signingProtocolDate": "2024-08-01"
    },
    "agencySettle": {
      "settleType": "1",
      "name": "张三",
      "bankCard": "9558801001151625944",
      "idCard": "152128198010141812",
      "phone": "13635309031",
      "headBankNo": "C1010511003703",
      "headBankName": "中国建设银行",
      "branchBankNo": "105100001036",
      "branchBankName": "中国建设银行北京新华支行"
    },
    "agencyFileList": [{"fileType": "1","fileId": "202311061704534941"}]
  }
}

请求参数:

参数名称	参数说明	是否必须	数据类型
agencyNo	服务商编号	true	string
agencyInfo	服务商基本信息	true	object
agencySettle	服务商结算信息	true	object
agencyFileList	服务商图片文件信息	true	array

请求参数 agencyInfo:

参数名称	参数说明	是否必须	数据类型
agencyName	服务商名称	true	string
parentAgencyNo	上级服务商编号(非一级必填)	false	string
level	层级	true	integer(int32)
businessType	企业类型（1-企业，2-个人）	true	string
contactName	联系人	true	string
contactPhone	联系人电话	true	string
contactEmail	联系邮箱	true	string
officeAddress	办公地址	true	string
provinceCode	所属省份编码	true	string
provinceName	所属省份名称	true	string
cityCode	所属城市编码	true	string
cityName	所属城市名称	true	string
enterpriseCode	统一社会信用代码（企业必填）	false	string
enterpriseName	企业名称（企业必填）	false	string
enterpriseAddress	注册地址	true	string
enterpriseCapital	注册资本	false	string
enterpriseStart	营业执照有效期开始时间 (yyyy-mm-dd)（企业必填）	false	string
enterpriseEnd	营业执照有效期结束时间(yyyy-mm-dd 长期：9999-12-31)（企业必填）	false	string
legalName	法人名称	true	string
legalIdCard	法人身份证	true	string
legalPhone	法人手机号	true	string
legalIdCardStart	法人身份证有效期开始时间(yyyy-mm-dd)	true	string
legalIdCardEnd	法人身份证有效期结束时间(yyyy-mm-dd 长期：9999-12-31)	true	string
signingName	签约主体名称	false	string
signingDate	签约日期	false	string
signingProtocolDate	协议签署日期	false	string

请求参数 agencySettle:

参数名称	参数说明	是否必须	数据类型
settleType	结算类型（1-对公结算，2-对私法人结算）	true	string
name	结算账户名	true	string
bankCard	结算卡号	true	string
idCard	结算人身份证	false	string
phone	预留手机号	false	string
headBankNo	总行编码	true	string
headBankName	总行名称	true	string
branchBankNo	支行编码（联行号）	true	string
branchBankName	支行名称	true	string

请求参数 agencyFileList:

参数名称	参数说明	是否必须	数据类型
fileType	文件类型(参考下面类型描述)	true	string
fileId	文件编号(纯数字)	true	string

注意事项

fileType 1 企业营业执照
2 法人身份证正面
3 法人身份证反面
4 结算人身份证正面
5 结算人身份证反面
6 加强业务管理告知函
7 风险责任承诺函
8 服务商检查评估报告
9 银行卡收单业务拓展协议一
10 银行卡收单业务拓展协议二
11 银行卡收单业务拓展协议三
12 结算对象银行卡正面照片

响应状态:

状态码	说明
200	OK

响应参数:

参数名称	参数说明	类型
result	result:成功或失败	boolean

响应示例:

{
	"data": {
		"result": true
	}
}

服务商开通DO

接口地址:/channel-app/api/agency/openD0

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

开通DO

请求示例:

{
  "param": {
    "agencyNo": "80000016"
  }
}

请求参数:

参数名称	参数说明	是否必须	数据类型
agencyNo	服务商编号	true	string

响应状态:

状态码	说明
200	OK

响应参数:

参数名称	参数说明	类型
result	result:成功或失败	boolean

响应示例:

{
	"data": {
		"result": true
	}
}

服务商（创建）​

服务商（修改）​

服务商开通DO​

服务商（创建）

服务商（修改）

服务商开通DO