1.1 分账方管理
优质
小牛编辑
132浏览
2023-12-01
1.1分账方管理
1.1.1分账方基本信息注册
【场景介绍】
当企业需要将收款资金分账给渠道方或者其他关联商户时,资金接收方也需要注册,注册信息主要是接收人的基本信息,包括银行卡信息、结算信息等。
【重要说明】分账注册成功后,其账户默认是冻结状态,只有在上传相应资质通过后,才能解冻正常使用。同时,确保分账方的名字务必准确,否则出错会影响后续的分账方结算。 |
---|
【调用流程】
【请求地址】
环境 | 接口服务URI |
---|---|
生产环境 | /rest/v1.0/merchant/registerLedgerMerchant |
1.1.1.1请求参数:
参数名称 | 参数含义 | 数据类型 | 必填(Y\/N) | 参数说明 |
---|---|---|---|---|
requestNo | 商户请求号 | String(32) | Y | |
merchantNo | 商户编号 | String(16) | Y | |
province | 分账方所在省份 | String(10) | Y | 分账方所在省,请根据数据 字典「易宝省市编号表.xls」,填 写中文。 |
city | 分账方所在城市 | String(20) | Y | 分账方所在市「易宝省市编号表.xls」,请根据数据字典,填写中文。 |
customerStyle | 商户类型 | Enum | Y | 个人-PERSON |
businessLicence | 营业执照号 | String(30) | N | customerStyle为ENTERPRISE时必填 |
signedName | 签约名称 | String(30) | Y | customerStyle为PERSON时填姓名,为ENTERPRISE填企业名称。 |
idCard | 身份证号 | String(18) | N | customerStyle为PERSON时必填 |
legalPerson | 法人姓名 | String(10) | N | customerStyle为ENTERPRISE时必填 |
contactor | 联系人 | String(20) | Y | 联系人姓名,最长允许20个汉字 |
bindMobile | 绑定手机 | String(11) | Y | 联系人的手机 |
邮箱 | String(30) | N | ||
bankAccountNumber | 结算银行卡号 | String(30) | Y | 结算用的银行卡号,必须为借记卡 |
accountName | 开户名 | String(20) | Y | 结算用的银行卡号开户名 |
bankAccountType | 卡类型 | String(12) | Y | 个人-PRIVATE_CASH |
bankName | 开户行 | String(50) | Y | 银行卡所在开户行,请根据数据字典「中国所有银行支行省市库表.xlsx」,填写中文。 |
bankCardProvince | 开户省 | String(10) | Y | 银行卡开户行所在省,请根据数据 字典「易宝省市编号表.xls」,填 写中文。 |
bankCardCity | 开户市 | String(20) | Y | 银行卡开户行所在市「易宝省市编号表.xls」,请根据数据字典,填写中文。 |
minSettleAmount | 最低结算额 | Amount | Y | >= 0.01 的数字,最大18位 |
riskReserveDay | 风险预存期 | Int | Y | 正整数,单位:天例如,当 riskReserveDay=N时, 意味着当天消费的金额,需要在N 个工作日后才会结算出款;如当N=1 时,则当天消费的金额,会在第二个工作日结算出款。 |
1.1.1.2返回参数:
参数名称 | 参数定义 | 参数说明 |
---|---|---|
ledgerNo | 分账方编号 | 分账方编号 |
code | 返回码 | 返回状态标识码 |
message | 返回信息 | 返回码的详细说明 |
1.1.2分账方资质上传
【场景介绍】
应合规方面的要求,钱麦方需要收集并保存分账方相关资质信息,钱麦方审核资质通过后,分账方才能开展业务。
【请求地址】
环境 | 接口服务URI |
---|---|
生产环境 | /rest/v1.0/merchant/uploadQualifications |
1.1.2.1请求参数
参数名称 | 参数含义 | 数据类型 | 必填 | 参数说明 |
---|---|---|---|---|
merchantNo | 商户编号 | String(32) | Y | |
ledgerNo | 分账方编号 | String(16) | Y | |
qualificationType | 证件类型 | Enum (20) | Y | 身份证正面-ID_CARD_FRONT 身份证背面-ID_CARD_BACK 银行卡正面-BANK_CARD_FRONT 银行卡背面-BANK_CARD_BACK 个人相片-PERSON_PHOTO 营业执照-BUSSINESS_LICENSE 工商证-BUSSINESS_CERTIFICATES 银行开户许可证-BANK_ACCOUNT_LICENCE 组织机构代码证-ORGANIZATION_CODE |
imgBase64Buffer | 文件流 | String(512000) | Y | 图片转base64编码的字符串 |
【重要说明】分账方可以分为个人和企业两种类型情况,需要开发者务必仔细确认。 |
---|
1、关于证件类型,个人类型账户必上传资质:身份证正、反面;个人相片(手持身份证照片),银行卡正面;
2、企业类型账户必上传资质:企业五证(营业执照,法人身份证正、反面,银行开户许可证,组织机构代码证, 税务登记证)。
3、上关于文件流,上传图片类型支持 jpg、jpeg、png,文件大小限制 512KB。
1.1.2.2返回参数
参数名称 | 参数定义 | 参数说明 |
---|---|---|
code | 返回码 | 请参考附录:返回码列表 |
message | 返回消息 | 返回码的详细说明 |
1.1.3商户余额查询
【场景介绍】
商户查询自身或其分账方待结算账户金额。
【请求地址】
环境 | 接口服务URI |
---|---|
生产环境 | /rest/v1.0/merchant/queryMerchantBalance |
1.1.3.1请求参数
参数名称 | 参数含义 | 数据类型 | 必填 | 参数说明 |
---|---|---|---|---|
merchantNo | 商户编号 | String(16) | Y |
1.1.3.2返回参数
参数名称 | 参数定义 | 参数说明 |
---|---|---|
balance | 余额 | 商户账户的可用余额 |
code | 返回码 | 请参考附录:返回码列表 |
message | 返回消息 | 返回码的详细说明 |