1.1 分账方管理

优质
小牛编辑
129浏览
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商户类型EnumY个人-PERSON
businessLicence营业执照号String(30)NcustomerStyle为ENTERPRISE时必填
signedName签约名称String(30)YcustomerStyle为PERSON时填姓名,为ENTERPRISE填企业名称。
idCard身份证号String(18)NcustomerStyle为PERSON时必填
legalPerson法人姓名String(10)NcustomerStyle为ENTERPRISE时必填
contactor联系人String(20)Y联系人姓名,最长允许20个汉字
bindMobile绑定手机String(11)Y联系人的手机
email邮箱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最低结算额AmountY>= 0.01 的数字,最大18位
riskReserveDay风险预存期IntY正整数,单位:天例如,当 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返回消息返回码的详细说明