银行卡相关接口

简介:银行卡相关接口

HOST:

联系人: huxn

Version:0.0.1

[TOC]

结算卡绑定

接口地址:/channel-app/api/bankCard/bind

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

结算卡绑定

请求示例:

{
  "param": {
    "merchantNo": "100000000000003",
    "bankCard": "9558801001151625944",
    "defaultSettleCard": "1",
    "provinceCode": "110000",
    "provinceName": "北京市",
    "cityCode": "110100",
    "cityName": "北京",
    "bankCode": "102",
    "bankName": "工商银行",
    "shortCode": "ICBC",
    "branchBankCode": "102100020778",
    "branchBankName": "中国工商银行股份有限公司北京西四环支行"
  }
}

请求参数:

参数名称	参数说明	是否必须	数据类型
merchantNo	商户编号	true	string
name	账户名	true	string
bankCard	银行卡号	true	string
phone	预留手机号	true	string
defaultSettleCard	默认结算卡(0：否；1：是)	true	string
provinceCode	所属省编码	false	string
provinceName	所属省名称	false	string
cityCode	所属市编码	false	string
cityName	所属市名称	false	string
bankCode	开户银行机构号	true	string
bankName	开户银行名称	true	string
shortCode	开户银行简码	false	string
branchBankCode	开户支行联行号	false	string
branchBankName	开户支行名称	false	string

响应状态:

状态码	说明
200	OK

响应参数:

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

响应示例:

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

查询结算卡列表

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

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

查询结算卡列表

请求示例:

{
  "param": {
    "merchantNo": "100000000000003"
  }
}

请求参数:

参数名称	参数说明	是否必须	数据类型
merchantNo	商户编号	true	string

响应状态:

状态码	说明
200	OK

响应参数:

参数名称	参数说明	类型
bankCardId	bankCardId:银行卡ID	string
bankCardNo	bankCardNo:银行卡号	string
bankCardNoMask	bankCardNoMask:银行卡号	string
bankCardType	bankCardType:银行卡类型(00：借记卡; 01：贷记卡)	string
defaultSettleCard	defaultSettleCard:默认结算卡(0：否；1：是)	string
icon	icon:图标	string
bankCode	bankCode:开户银行机构号	string
bankName	bankName:开户银行名称	string
shortCode	shortCode:开户银行简码	string
branchBankCode	branchBankCode:开户支行联行号	string
branchBankName	branchBankName:开户支行名称	string

响应示例:

{"data":[{
  "bankCardId": "35",
  "bankCardNo": "9558801001151625944",
  "bankCardNoMask": "955880****5944",
  "bankCardType": "00",
  "defaultSettleCard": "1",
  "icon": "https://api.ice.run/file-api/api/FILE_VIEW?code=04ribftI",
  "bankCode": "102",
  "bankName": "工商银行",
  "shortCode": "ICBC",
  "branchBankCode": "102100020778",
  "branchBankName": "中国工商银行股份有限公司北京西四环支行"
}, {
  "bankCardId": "34",
  "bankCardNo": "9558801001151625942",
  "bankCardNoMask": "955880****5942",
  "bankCardType": "00",
  "defaultSettleCard": "0",
  "icon": "https://api.ice.run/file-api/api/FILE_VIEW?code=04ribftI",
  "bankCode": "102",
  "bankName": "工商银行",
  "shortCode": "ICBC",
  "branchBankCode": "102100020778",
  "branchBankName": "中国工商银行股份有限公司北京西四环支行"
}, {
  "bankCardId": "31",
  "bankCardNo": "9558801001151625941",
  "bankCardNoMask": "955880****5941",
  "bankCardType": "00",
  "defaultSettleCard": "0",
  "icon": "https://api.ice.run/file-api/api/FILE_VIEW?code=04ribftI",
  "bankCode": "102",
  "bankName": "工商银行",
  "shortCode": "ICBC",
  "branchBankCode": "102100020778",
  "branchBankName": "中国工商银行股份有限公司北京西四环支行"
}]
}

修改结算卡信息

接口地址:/channel-app/api/bankCard/updateBankCard

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

修改结算卡信息

请求示例:

{
  "param": {
    "merchantNo": "M700010001EEbBTYO9",
    "bankCard": "6222020808000008631",
    "accountType": "03",
    "provinceCode": "110000",
    "provinceName": "北京",
    "cityCode": "110100",
    "cityName": "北京市",
    "bankCode": "102",
    "bankName": "中国工商银行",
    "shortCode": "ICBC",
    "branchBankCode": "102100020778",
    "branchBankName": "中国工商银行股份有限公司北京西四环支行",
    "nuccCode": "C1010211000012"
  }
}

请求参数:

参数名称	参数说明	是否必须	数据类型
merchantNo	商户编号(18位)	true	string
bankCard	银行卡号	true	string
accountType	账户类型(03：对私户)	false	string
provinceCode	开户行所在省编码	false	string
provinceName	开户行所在省名称	false	string
cityCode	开户行所在市编码	false	string
cityName	开户行所在市名称	false	string
bankCode	开户银行机构号	false	string
bankName	开户银行名称	false	string
shortCode	开户银行简码	false	string
branchBankCode	开户支行联行号	false	string
branchBankName	开户支行名称	false	string
nuccCode	网联机构代码	false	string

响应状态:

状态码	说明
200	OK

响应参数:

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

响应示例:

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

设置默认结算银行卡

接口地址:/channel-app/api/bankCard/defaultBankCard

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

设置默认结算银行卡

请求示例:

{
  "param": {
    "merchantNo": "M7000333600A2ghiS5",
    "bankCardId": "123"
  }
}

请求参数:

参数名称	参数说明	是否必须	数据类型
merchantNo	商户编号(18位)	true	string
bankCardId	银行卡ID	true	string

响应状态:

状态码	说明
200	OK

响应参数:

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

响应示例:

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

结算卡绑定​

查询结算卡列表​

修改结算卡信息​

设置默认结算银行卡​

结算卡绑定

查询结算卡列表

修改结算卡信息

设置默认结算银行卡