跳到主要内容

商户进件/信息变更

简介:商户进件/信息变更

HOST:

联系人: huxn

Version:0.0.1

[TOC]

商户入网​

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

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

商户入网

请求示例:

{
  "param": {
    "name": "张三",
    "phone": "13103321231",
    "idCard": "110119200001122111",
    "idCardStart": "2020-01-01",
    "idCardEnd": "2023-01-01",
    "idCardFront": "202402281428191882",
    "idCardBack": "202402281428191882",
    "provinceCode": "110000",
    "provinceName": "北京市",
    "cityCode": "110100",
    "cityName": "北京",
    "areaCode": "110101",
    "areaName": "东城区",
    "address": "110街道",
    "domain32": "1000",
    "occupation": "1",
    "longitude": "111.11",
    "latitude": "111.11"
  }
}

请求参数:

参数名称参数说明是否必须数据类型
name商户名称truestring
phone手机号truestring
idCard身份证号truestring
idCardStart身份证有效期开始时间truestring
idCardEnd身份证有效期结束时间长期传9999-12-31truestring
idCardFront身份证正面照truestring
idCardBack身份证反面照truestring
provinceCode所属省份编码truestring
provinceName所属省份名称truestring
cityCode所属城市编码truestring
cityName所属城市名称truestring
areaCode所属区编码truestring
areaName所属区名称truestring
address详细地址truestring
domain32银联32域truestring
occupation职业truestring
longitude经度falsestring
latitude纬度falsestring

响应状态:

状态码说明
200OK

响应参数:

参数名称参数说明类型
merchantNomerchantNo:商户编号string
channelMerchantNochannelMerchantNo:通道商户号string

响应示例:

{
	"data": {
		"merchantNo": "100000000000001",
		"channelMerchantNo": "M701058121YRkVxhY6"
	}
}

商户开通产品​

接口地址:/channel-app/api/merchant/open

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

商户开通产品

请求示例:

{
  "param": {
    "merchantNo": "100000000000001",
    "channelMerchantNo": "M701058121YRkVxhY6"
  }
}

请求参数:

参数名称参数说明是否必须数据类型
merchantNo商户编号truestring
channelMerchantNo通道商户号truestring

响应状态:

状态码说明
200OK

响应参数:

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

响应示例:

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

商户注册地址变更​

接口地址:/channel-app/api/merchant/addressUpdate

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

商户注册地址变更

请求示例:

{
  "param": {
    "merchantNo": "100000000000001",
    "provinceCode": "120000",
    "provinceName": "天津市",
    "cityCode": "120100",
    "cityName": "天津",
    "areaCode": "120101",
    "areaName": "和平区",
    "address": "滨江道",
    "domain32": "1128",
    "occupation": "1",
    "longitude": "117.153267",
    "latitude": "42.020698"
  }
}

请求参数:

参数名称参数说明是否必须数据类型
merchantNo商户编号truestring
provinceCode所属省份编码truestring
provinceName所属省份名称truestring
cityCode所属城市编码truestring
cityName所属城市名称truestring
areaCode所属区县编码truestring
areaName所属区县名称truestring
address详细地址truestring
domain32银联32域truestring
occupation职业falsestring
longitude经度falsestring
latitude纬度falsestring

响应状态:

状态码说明
200OK

响应参数:

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

响应示例:

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

商户关联列表查询​

接口地址:/channel-app/api/merchant/merchantRelateList

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

商户关联列表查询

请求示例:

{
  "param": {
    "idCard": "1101192000111221111"
  }
}

请求参数:

参数名称参数说明是否必须数据类型
idCard身份证号truestring

响应状态:

状态码说明
200OK

响应参数:

参数名称参数说明类型
merchantNomerchantNo:商户编号string
channelMerchantNochannelMerchantNo:通道商户号string

响应示例:

{
  "data": {
    "merchantNo": "100000000000098",
    "channelMerchantNo": "M708010232bvrSWnI3"
  }
}

个人身份资料变更​

接口地址:/channel-app/api/merchant/authIdCardUpdate

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

个人身份资料变更

请求示例:

{
  "param": {
    "merchantNo": "100000000000098",
    "idCardStart": "2022-01-01",
    "idCardEnd": "2032-01-01",
    "idCardFront": "202404031654127854",
    "idCardBack": "202404031654129914"
  }
}

请求参数:

参数名称参数说明是否必须数据类型
merchantNo商户编号truestring
idCardStart身份证有效期开始时间truestring
idCardEnd身份证有效期结束时间truestring
idCardFront身份证正面照truestring
idCardBack身份证反面照truestring

响应状态:

状态码说明
200OK

响应参数:

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

响应示例:

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

查询费率​

接口地址:/channel-app/api/rate/list

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

查询费率

请求示例:

{
  "param": {
    "factorySequenceNo": "00000302QRNL09523999"
  }
}

请求参数:

参数名称参数说明是否必须数据类型
factorySequenceNo终端序列号truestring

响应状态:

状态码说明
200OK

响应参数:

参数名称参数说明类型
codecode:响应编码，6 位数字字符串string
messagemessage:响应信息，字符串string
datadata:响应数据array
factorySequenceNofactorySequenceNo:终端序列号string
productCodeproductCode:产品编码string
productNameproductName:产品名称string
policyNopolicyNo:政策编号string
policyNamepolicyName:政策名称string
rateNorateNo:费用项编号string
rateNamerateName:费用项名称string
rateValuerateValue:费率值string
rateBeginrateBegin:费率起始值string
rateEndrateEnd:费率结束值string
createTimecreateTime:创建时间string(date-time)
updateTimeupdateTime:修改时间string(date-time)

响应示例:

{
  "data": [{
    "factorySequenceNo": "00000302QRNL09523999",
    "productCode": "100",
    "productName": "金墩墩",
    "policyNo": "20231013161652365",
    "policyName": "测试政策",
    "rateNo": "R1013",
    "rateName": "刷卡结算手续费",
    "rateValue": "131",
    "rateBegin": null,
    "rateEnd": null,
    "createTime": "2024-05-10T16:12:15",
    "updateTime": "2024-05-24T13:24:48"
  }, {
    "factorySequenceNo": "00000302QRNL09523999",
    "productCode": "100",
    "productName": "金墩墩",
    "policyNo": "20231013161652365",
    "policyName": "测试政策",
    "rateNo": "R1014",
    "rateName": "扫码交易手续费",
    "rateValue": "0.4",
    "rateBegin": null,
    "rateEnd": null,
    "createTime": "2024-05-10T16:12:15",
    "updateTime": "2024-05-23T16:07:47"
  }, {
    "factorySequenceNo": "00000302QRNL09523999",
    "productCode": "100",
    "productName": "金墩墩",
    "policyNo": "20231013161652365",
    "policyName": "测试政策",
    "rateNo": "R1015",
    "rateName": "扫码结算手续费",
    "rateValue": "100",
    "rateBegin": null,
    "rateEnd": null,
    "createTime": "2024-05-10T16:12:15",
    "updateTime": "2024-05-23T16:08:30"
  }, {
    "factorySequenceNo": "00000302QRNL09523999",
    "productCode": "100",
    "productName": "金墩墩",
    "policyNo": "20231013161652365",
    "policyName": "测试政策",
    "rateNo": "R1016",
    "rateName": "借记卡封顶手续费",
    "rateValue": "400",
    "rateBegin": null,
    "rateEnd": null,
    "createTime": "2024-05-10T16:12:15",
    "updateTime": "2024-05-23T16:08:30"
  }, {
    "factorySequenceNo": "00000302QRNL09523999",
    "productCode": "100",
    "productName": "金墩墩",
    "policyNo": "20231013161652365",
    "policyName": "测试政策",
    "rateNo": "R1012",
    "rateName": "刷卡交易手续费",
    "rateValue": "0.56",
    "rateBegin": null,
    "rateEnd": null,
    "createTime": "2024-05-10T16:12:15",
    "updateTime": "2024-05-23T16:08:30"
  }]
}

RateApi

修改费率​

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

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

修改费率

请求示例:

{
  "param": {
    "factorySequenceNo": "00000302QRNL09523999",
    "productCode": "100",
    "productName": "金墩墩",
    "innerParamList": [{
      "rateNo": "R1013",
      "rateName": "刷卡结算手续费",
      "rateValue": "1.2"
    }]
  }
}

请求参数:

参数名称参数说明是否必须数据类型
factorySequenceNo终端序列号truestring
productCode产品编码truestring
productName产品名称truestring
innerParamList产品费用项truearray

请求参数innerParamList:

参数名称参数说明是否必须数据类型
rateNo费用项编号truestring
rateName费用项名称truestring
rateValue费率值（数值时单位为分；百分比时为小数）truestring

响应状态:

状态码说明
200OK

响应参数:

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

响应示例:

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

结算方式设置​

接口地址:/channel-app/api/rate/settleModeUpdate

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

结算方式设置

请求示例:

{
  "param": {
    "merchantNo": "100000000000003",
    "settleMode": "S",
    "settleCycle": 0
  }
}

请求参数:

参数名称参数说明是否必须数据类型
merchantNo商户编号truestring
settleMode结算方式（S，T）truestring
settleCycle结算周期falseinteger(int32)

响应状态:

状态码说明
200OK

响应参数:

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

响应示例:

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