盛付通-shengpay请求参数
接口描述:渠道进件接口applymentInfo参数说明
参数说明
适用对象:代理商 特约商户
参数类型:JSON格式字符串
“必填”字段取值“Y“:必填;“N”:非必填;“C”代表条件必填;
请求参数
| 参数名 | 中文名 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| mchFullName | 商户全称 | C | String | 商户类型为2、3、4、7、8时必填。 商户名称全称; 注意上传与证书名称一致 ; 示例值:河北计全科技有限公司 |
| mchShortName | 商户简称 | Y | String | 示例值:河北计全科技 |
| merchantType | 商户类型 | Y | String | 1-个人 2-个体工商户 3-企业 4-党机关及事业单位 7-事业单位 8-社会组织 示例值:2 |
| mccCode | 行业MCC | Y | String | 行业MCC详见基础参数信息 示例值:5013 |
| certType | 证书类型 | C | String | 商户类型为2、3、4、7、8时必填。 PUBLIC_INSTITUTION-事业单位法人证书 GOVERNMENT_OFFICE-政府机关统一社会信用代码证书 SOCIAL_ORGANIZATION_0 1-社会组织统一社会信用代码证书 SOCIAL_ORGANIZATION_02-社会团体法人登记证书 SOCIAL_ORGANIZATION_0 3-民办非企业单位登记证书 SOCIAL_ORGANIZATION_04-基金会法人登记证书 SOCIAL_ORGANIZATION_05-执业许可证/执业证 SOCIAL_ORGANIZATION_06-基层群众性自治组织特别法人统一社会信用代码证 SOCIAL_ORGANIZATION_07-农村集体经济组织登记证 SOCIAL_ORGANIZATION_08-农民专业合作社法人营业执照 SOCIAL_ORGANIZATION_09-宗教活动场所登记证 SOCIAL_ORGANIZATION_10-慈善组织公开募捐资格证书 REGISTRATION_CERTIFICATE_HK-香港企业登记证书 REGISTRATION_CERTIFICATE_FR-国外企业登记证书 示例值:SOCIAL_ORGANIZATION_01 |
| licenseImg | 证书照片 | C | String | 商户类型为2、3、4、7、8时必填。 上传对应类型的证书照片; 通过图片上传接口获得文件ID 示例值:abae6a9a-d584-422d-9fe0-5c1fefa33af5 |
| licensePerson | 证书法定代表人 | C | String | 商户类型为2、3、4、7、8时必填。 示例值:张三 |
| licenseAddress | 证书注册地址 | C | String | 商户类型为2、3、4、7、8时必填。 示例值:上海市徐汇区宜山路700号普天信息产业园2期C5栋 |
| licenseNo | 证书编号 | C | String | 商户类型为2、3、4、7、8时必填。 示例值:92650109MA79R8E308 |
| licenseEffectBegin | 证书起始有效期 | C | String | 商户类型为2、3、4、7、8时必填。 日期格式:yyyy-MM-dd。 示例值:2022-01-25 |
| licenseEffectEnd | 证书有效期截止 | C | String | 商户类型为2、3、4、7、8时必填。 日期格式:yyyy-MM-dd,若为长期有效,请传入“长期”。 示例值:2022-01-25 |
| contactName | 联系人姓名 | Y | String | 示例值:张三 |
| contactPhone | 联系人电话 | Y | String | 示例值:166xxxxxxxx |
| contactEmail | 联系人邮箱 | Y | String | 示例值:166xxxxxxxx@163.com |
| contactIdcard1Img | 联系人身份证人像面照片 | C | String | 商户类型为2、3、4、7、8时必填。 通过图片上传接口获得文件ID 示例值:abae6a9a-d584-422d-9fe0-5c1fefa33af5 |
| contactIdcard2Img | 联系人身份证国徽面照片 | C | String | 商户类型为2、3、4、7、8时必填。 通过图片上传接口获得文件ID 示例值:abae6a9a-d584-422d-9fe0-5c1fefa33af5 |
| contactIdcardNo | 联系人身份证号 | C | String | 商户类型为2、3、4、7、8时必填。 年龄不能小于18岁且不能大于80岁; 示例值:310112200001018888 |
| contactIdcardEffectBegin | 联系人身份证起始有效期 | C | String | 商户类型为2、3、4、7、8时必填。 日期格式:yyyy-MM-dd。 示例值:2022-01-25 |
| contactIdcardEffectEnd | 联系人身份证结束有效期 | C | String | 商户类型为2、3、4、7、8时必填。 日期格式:yyyy-MM-dd,若为长期有效,请传入“长期”。 示例值:2022-01-25 |
| contactIdcardAddress | 联系人身份证居住地址 | C | String | 商户类型为2、3、4、7、8时必填。 示例值:上海市徐汇区宜山路700号普天信息产业园2期C5栋 |
| address | 商户详细经营地址 | Y | String | 示例值:河北省沧州市华商大厦408 |
| areaCode | 商户经营省市区编码 | Y | [] | 数组格式包含省市区三个地区码; 地区码详见基础参数信息 示例值:["130000", "130900", "130902"] |
| storeOuterImg | 商户门头照 | Y | String | 通过图片上传接口获得文件ID 示例值:abae6a9a-d584-422d-9fe0-5c1fefa33af5 |
| storeCashierImg | 商户收银台照片 | Y | String | 通过图片上传接口获得文件ID 示例值:abae6a9a-d584-422d-9fe0-5c1fefa33af5 |
| storeInnerImg | 商户店内环境照 | Y | String | 通过图片上传接口获得文件ID 示例值:abae6a9a-d584-422d-9fe0-5c1fefa33af5 |
| taxCertCopy | 税务登记证照片 | C | String | 商户类型为4、7、8时必填。 通过图片上传接口获得文件ID 示例值:abae6a9a-d584-422d-9fe0-5c1fefa33af5 |
| idcard1Img | 法人身份证人像面照片 | Y | String | 通过图片上传接口获得文件ID 示例值:abae6a9a-d584-422d-9fe0-5c1fefa33af5 |
| idcard2Img | 法人身份证国徽面照片 | Y | String | 通过图片上传接口获得文件ID 示例值:abae6a9a-d584-422d-9fe0-5c1fefa33af5 |
| idcardName | 法人身份证姓名 | Y | String | 示例值:张三 |
| idcardNo | 法人身份证号 | Y | String | 年龄不能小于18岁且不能大于80岁; 示例值:310112200001018888 |
| idcardEffectBegin | 法人身份证起始有效期 | Y | String | 日期格式:yyyy-MM-dd。 示例值:2022-01-25 |
| idcardEffectEnd | 法人身份证结束有效期 | Y | String | 日期格式:yyyy-MM-dd,若为长期有效,请传入“长期”。 示例值:2022-01-25 |
| idcardAddress | 法人身份证居住地址 | Y | String | 示例值:河北省沧州市华商大厦408 |
| idcardInHandImg | 法人手持身份证照片 | Y | String | 通过图片上传接口获得文件ID 示例值:abae6a9a-d584-422d-9fe0-5c1fefa33af5 |
| autoWithdraw | 是否自动结算 | Y | String | 是否自动结算: Y-自动结算 N-手动结算; 示例值:Y |
| settAccountType | 结算账号类型 | Y | String | C-对私 B-对公; 示例值:C |
| settAccountLicenseImg | 结算银行卡照片 | C | String | 结算账号类型为:C(对私) 必填 通过图片上传接口获得文件ID 示例值:abae6a9a-d584-422d-9fe0-5c1fefa33af5 |
| companyAccountLicenseImg | 开户许可证照片 | C | String | 结算账号类型为:B(对公) 必填 通过图片上传接口获得文件ID 示例值:abae6a9a-d584-422d-9fe0-5c1fefa33af5 |
| settAccountName | 结算账户名称 | Y | String | settAccountType = C 对私时,传入结算卡账户姓名 示例值:张三 settAccountType = B 对公时,传入企业名称 示例值:河北计全科技有限公司 |
| settAccountNo | 结算账户号 | Y | String | 示例值:98140008801800008888 |
| settAccountBankName | 开户银行 | Y | String | 参数值详见基础参数信息 示例值:中国银行 |
| settAccountBankBranchAreaCode | 开户银行支行所在地区编码 | Y | [] | 地区码详见基础参数信息 示例值:["130000", "130900", "130902"] |
| settAccountBankBranchName | 开户银行支行名称 | Y | String | 示例值:中国银行沧州市支行 |
| settAccountIdcardNo | 持卡人身份证号 | C | String | merchantType = 2 、3时;结算账号settAccountType=C对私 且settAccountName结算账户名与法人名称不一致时,必填(对私非法人结算) 年龄不能小于18岁且不能大于80岁; 示例值:310112200001018888 |
| settAccountIdcard1Img | 持卡人身份证人像照 | C | String | merchantType = 2 、3时;结算账号settAccountType=C对私 且settAccountName结算账户名与法人名称不一致时 必填(对私非法人结算) 通过图片上传接口获得文件ID 示例值:abae6a9a-d584-422d-9fe0-5c1fefa33af5 |
| settAccountIdcard2Img | 持卡人身份证国徽面照 | C | String | merchantType = 2 、3时;结算账号settAccountType=C对私 且settAccountName结算账户名与法人名称不一致时 必填(对私非法人结算) 通过图片上传接口获得文件ID 示例值:abae6a9a-d584-422d-9fe0-5c1fefa33af5 |
| settAccountIdcardEffectBegin | 持卡人身份证起始有效期 | C | String | merchantType = 2 、3时;结算账号settAccountType=C对私 且settAccountName结算账户名与法人名称不一致时 必填(对私非法人结算) 日期格式:yyyy-MM-dd。 示例值:2022-01-25 |
| settAccountIdcardEffectEnd | 持卡人身份证结束有效期 | C | String | merchantType = 2 、3时;结算账号settAccountType=C对私 且settAccountName结算账户名与法人名称不一致时 必填(对私非法人结算) 日期格式:yyyy-MM-dd,若为长期有效,请传入“长期”。 示例值:2022-01-25 |
| companyAccountName | 对公账户名称 | C | String | merchantType =3时;结算账号settAccountType=C对私 且settAccountName结算账户名与法人名称一致时 必填(企业对私法人结算) ----------------------------------------------------- merchantType =2时; 结算账号settAccountType=C对私; companyAccountType=B 且settAccountName结算账户名与法人名称不一致时 必填(个体对私结算非法人对公户) ----------------------------------------------------- merchantType =2时; 结算账号settAccountType=C对私 companyAccountType=C 且settAccountName结算账户名与法人名称不一致时 必填(个体对私结算非法人对私户) 示例值:张三 |
| companyAccountNo | 对公账户银行卡号 | C | String | merchantType =3时;结算账号settAccountType=C对私 且settAccountName结算账户名与法人名称一致时 必填(企业对私法人结算) ----------------------------------------------------- merchantType =2时; 结算账号settAccountType=C对私; companyAccountType=B 且settAccountName结算账户名与法人名称不一致时 必填(个体对私结算非法人对公户) ----------------------------------------------------- merchantType =2时; 结算账号settAccountType=C对私; companyAccountType=C 且settAccountName结算账户名与法人名称不一致时 必填(个体对私结算非法人对私户) 示例值:98140008801800008888 |
| companyAccountBankName | 对公账户开户银行名称 | C | String | merchantType =3时;结算账号settAccountType=C对私 且settAccountName结算账户名与法人名称一致时 必填(企业对私法人结算) ----------------------------------------------------- merchantType =2时; 结算账号settAccountType=C对私; companyAccountType=B 且settAccountName结算账户名与法人名称不一致时 必填(个体对私结算非法人对公户) 参数值详见基础参数信息 示例值:中国银行 |
| companyAccountBankBranchAreaCode | 对公账户开户支行所在地区编码 | C | String | merchantType =3时;结算账号settAccountType=C对私 且settAccountName结算账户名与法人名称一致时 必填(企业对私法人结算) ----------------------------------------------------- merchantType =2时; 结算账号settAccountType=C对私; companyAccountType=B 且settAccountName结算账户名与法人名称不一致时 必填(个体对私结算非法人对公户) 地区码详见基础参数信息 示例值:130902 |
| companyAccountBankBranchName | 对公账户开户支行名称 | C | String | merchantType =3时;结算账号settAccountType=C对私 且settAccountName结算账户名与法人名称一致时 必填(企业对私法人结算) ----------------------------------------------------- merchantType =2时; 结算账号settAccountType=C对私; companyAccountType=B 且settAccountName结算账户名与法人名称不一致时 必填(个体对私结算非法人对公户) 示例值:中国银行沧州市支行 |
| companyAccountLicenseImg | 开户许可证照片 | C | String | merchantType =3时;结算账号settAccountType=C对私 且settAccountName结算账户名与法人名称一致时 必填(企业对私法人结算) ----------------------------------------------------- merchantType =2时; 结算账号settAccountType=C对私; companyAccountType=B 且settAccountName结算账户名与法人名称不一致时 必填(个体对私结算非法人对公户) ----------------------------------------------------- merchantType =2时; 结算账号settAccountType=C对私; companyAccountType=C 且settAccountName结算账户名与法人名称不一致时 必填(个体对私结算非法人对私户) 通过图片上传接口获得文件ID 示例值:abae6a9a-d584-422d-9fe0-5c1fefa33af5 |
| companyAccountType | 认证类型 | C | String | merchantType =2时; 结算账号settAccountType=C对私; 且settAccountName结算账户名与法人名称不一致时 必填(个体对私结算非法人对公户) 认证类型:C-法人银行卡 B-个体户对公账户 示例值:C |
| paywayFeeList | 费率 | Y | jsonArray | 产品费率开通信息,详见下方说明 |
| companyBeneficiaryList | 受益人信息 | C | jsonArray | merchantType =3 企业类型时必填 受益人信息详见下方说明 |
| isDivision | 是否开通订单分账 | N | String | 0-不开通 1-开通; 示例值:0 |
| divisionFeeRate | 订单分账费率 | C | String | isDivision=1时必填 千分比; 示例:0.005 |
companyBeneficiaryList-受益人信息
| 参数名 | 中文名 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| idcardName | 受益人姓名 | Y | String | 示例值;张三 |
| idcardNo | 受益人身份证号 | Y | String | 年龄不能小于18岁且不能大于80岁; 示例值:310112200001018888 |
| idcard1Img | 受益人身份证人像面照片 | Y | String | 通过图片上传接口获得文件ID 示例值:abae6a9a-d584-422d-9fe0-5c1fefa33af5 |
| idcard2Img | 受益人身份证国徽面照片 | Y | String | 通过图片上传接口获得文件ID 示例值:abae6a9a-d584-422d-9fe0-5c1fefa33af5 |
| idcardAddress | 受益人身份证居住地址 | Y | String | 示例值:河北省沧州市华商大厦408 |
| idcardEffectBegin | 受益人身份证起始有效期 | Y | String | 日期格式:yyyy-MM-dd。 示例值:2022-01-25 |
| idcardEffectEnd | 受益人身份证结束有效期 | Y | String | 日期格式:yyyy-MM-dd,若为长期有效,请传入“长期”。 示例值:2022-01-25 |
paywayFeeList-费率产品信息
paywayFeeList请求参数示例:基础参数
| 参数名 | 中文名 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| wayCode | 支付产品代码 | Y | String | 可配置的支付产品代码详见下述说明; 示例值;WX_BAR |
| feeType | 费率方式 | Y | String | 当wayCode产品代码为: UP_QR、UP_BAR、UP_JSAPI、UP_WAP、UP_PC、YSF_BAR、YSF_JSAPI 上述产品类型时参数值固定为:LEVEL 费率方式: SINGLE-单笔 LEVEL-阶梯 示例值:SINGLE 单笔费率参数示例 阶梯费率参数示例 |
| feeRate | 费率值(百分比) | C | String | 当feeType = SINGLE时必填; (0.38%)示例值:0.0038 |
| minFee | 最低手续费(分) | C | String | 当wayCode产品代码为: UP_QR、UP_BAR、UP_JSAPI、UP_WAP、UP_PC、YSF_BAR、YSF_JSAPI 上述产品类型时必填 示例值:100 |
| maxFee | 最大手续费(分) | C | String | 当wayCode产品代码为: UP_QR、UP_BAR、UP_JSAPI、UP_WAP、UP_PC、YSF_BAR、YSF_JSAPI 上述产品类型时必填 示例值:2000 |
| levelList | 费率阶梯 | C | jsonArray | 当wayCode产品代码为: UP_QR、UP_BAR、UP_JSAPI、UP_WAP、UP_PC、YSF_BAR、YSF_JSAPI 上述产品类型时必填 银联阶梯费率配置1000以上费率及1000以下费率 |
| creditCardPaywayFee | 贷记卡费率配置 | C | String | 当wayCode产品代码为: UP_QR、UP_BAR、UP_JSAPI、UP_WAP、UP_PC、YSF_BAR、YSF_JSAPI 上述产品类型时必填 json字符串类型参数; 贷记卡费率配置信息,与paywayFeeList数据结构相同; 若配置银联产品paywayFeeList默认为借记卡费率配置信息。 |
wayCode 支持的支付产品代码
| 产品类型 | wayCode | 产品名称 |
|---|---|---|
| 支付宝 | ALI_BAR | 支付宝条码 |
| 支付宝 | ALI_JSAPI | 支付宝生活号 |
| 支付宝 | ALI_LITE | 支付宝小程序 |
| 支付宝 | ALI_QR | 支付宝二维码 |
| 微信 | WX_BAR | 微信条码 |
| 微信 | WX_JSAPI | 微信公众号 |
| 微信 | WX_LITE | 微信小程序 |
| 银联 | YSF_BAR | 云闪付条码 |
| 银联 | YSF_JSAPI | 云闪付jsapi |
整体参数请求示例:(实际请求时json参数需转换为字符串类型,以下参数为显示效果)
{
"ifCode": "shengpay",
"mchInfo": {
"loginUsername": "m1753757755",
"contactEmail": "18855554444@qq.com",
"contactName": "张三",
"mchName": "入网商户",
"loginPassword": "jeepay888888",
"mchShortName": "入网商户",
"contactTel": "18855554444"
},
"agentNo": "A1682391658",
"extParam": "测试商户",
"appId": "6883345446c81f673bc26a25",
"sign": "48254AA03C151B274B75CB1C558A13C0",
"notifyUrl": "https://www.jeequan.com/notify.htm",
"signType": "MD5",
"applymentInfo": {
"isDivision": 1,
"idcardNo": "1309021991060800000",
"idcardName": "张三",
"mccCode": "5681",
"idcard2Img": "abae6a9a-d584-422d-9fe0-5c1fefa33af5",
"idcardEffectEnd": "2042-01-20",
"divisionFeeRate": 0.001,
"contactName": "张三",
"settAccountType": "C",
"mchFullName": "万科理发店",
"idcard1Img": "abae6a9a-d584-422d-9fe0-5c1fefa33af5",
"areaCode": ["130000", "130900", "130902"],
"storeCashierImg": "abae6a9a-d584-422d-9fe0-5c1fefa33af5",
"mchShortName": "11",
"settAccountName": "张三",
"settAccountLicenseImg": "abae6a9a-d584-422d-9fe0-5c1fefa33af5",
"storeInnerImg": "abae6a9a-d584-422d-9fe0-5c1fefa33af5",
"merchantType": 1,
"address": "河北省沧州市新华区进修官邸",
"contactEmail": "41511111@qq.com",
"idcardInHandImg": "abae6a9a-d584-422d-9fe0-5c1fefa33af5",
"storeOuterImg": "abae6a9a-d584-422d-9fe0-5c1fefa33af5",
"idcardAddress": "河北省沧州市新华区黄河东xxxxxx",
"settAccountNo": "622661234567890",
"idcardEffectBegin": "2022-01-20",
"contactPhone": "18903170000",
"paywayFeeList": [{
"wayCode": "WX_BAR",
"feeType": "SINGLE",
"state": 1,
"applymentSupport": 0,
"feeRate": 1.23
}, {
"wayCode": "WX_JSAPI",
"feeType": "SINGLE",
"state": 1,
"applymentSupport": 0,
"feeRate": 1.23
}, {
"wayCode": "WX_LITE",
"feeType": "SINGLE",
"state": 1,
"applymentSupport": 0,
"feeRate": 1.23
}]
},
"reqTime": "1753757755230",
"mchNo": "M1753429075",
"version": "1.0"
}