登录 热线：400-088-8816
开放资源

商户平台

第三方平台

报单接口列表 (结算信息描述)

需要授权

通过该接口录入商户结算信息。

保存结算信息请求接口：

POST请求地址：

环境 https请求地址
正式环境 https://openapi.duolabao.com/v2/agent/declare/settleinfo/create

公共请求参数：

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
customerNum String 是 32 商户编号 10001114749829775330009
bankAccountName String 是 32 银行账户名称 哆啦宝
bankAccountNum String 是 32 银行账户编号 2323232323232323
province String 是 32 商户所属省份（参见1.1） 北京
city String 是 32 商户所属城市（参见1.2） 北京
bankBranchName String 是 32 银行分行名称（参见1.7） 招商银行北京分行
bankName String 是 32 银行名称（参见1.6） 招商银行
settleAmount String 是 32 结算金额，起结金额必须大于等于1 1.00
payBankList num String 是 32 支付类型编号（参见1.5） 10031414639876930831001
rate String 是 32 费率（参见1.5） 0.38
accountType String 是 32 账户类型，PUBLIC(对公)/PRIVATE(对私) PUBLIC
phone String 是 32 银行预留手机号 18201223907
privateType String 对私时必填 32 个体和个人 个人PERSON,个体INDIVIDUAL
settlerCertificateCode String 否 32 结算人身份证号 230604199304163012
settlerCertificateStartDate String 否 32 结算人身份证开始时间 2017-11-11
settlerCertificateEndDate String 否 32 结算人身份证结束时间 2018-11-11

请求JSON示例值：

  • JSON示例
  • 1 {
    2 "customerNum": "10001114749829775330009",
    3 "bankAccountName": "哆啦宝",
    4 "bankAccountNum": "2323232323232323",
    5 "province": "北京",
    6 "city": "北京",
    7 "bankBranchName": "招商银行北京分行",
    8 "bankName": "招商银行",
    9 "phone": "18201223908",
    10 "settleAmount": "1.00",
    11 "payBankList": [
    12 {
    13 "num": "10031414639876930831001",
    14 "rate": "0.38"
    15 }，
    16 {
    17 "num": "10031414639876930831004",
    18 "rate": "0.38"
    19 }，
    20 {
    20 "num": "10031414639876930831005",
    21 "rate": "0.38"
    22 }
    23 ]
    24 "accountType": "PRIVATE",
    24 "privateType": "PERSON",
    25 "settlerCertificateCode": "230604199304163012",
    26 "settlerCertificateStartDate": "2017-11-11",
    27 "settlerCertificateEndDate": "2018-11-11"
    28 }

返回参数JSON格式：

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
settleNum String 是 32 结算编码 10051514750484432790012

响应JSON示例：

  • JSON示例
  • 1 {
    2 "data": {
    3 "settleNum": "10051514750484432790012"
    4 },
    5 "result": "success"
    6 }

修改结算信息请求接口：

POST请求地址：

环境 https请求地址
正式环境 https://openapi.duolabao.com/v2/agent/declare/settleinfo/modify

公共请求参数：

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
settleNum String 是 32 结算编码 10051514750484432790012
customerNum String 是 32 商户编号 10001114749829775330009
bankAccountName String 是 32 银行账户名称 哆啦宝
bankAccountNum String 是 32 银行账户编号 2323232323232323
province String 是 32 商户所属省份（参见1.1） 北京
city String 是 32 商户所属城市（参见1.2） 北京
bankBranchName String 是 32 银行分行名称（参见1.7） 招商银行北京分行
bankName String 是 32 银行名称（参见1.6） 招商银行
settleAmount String 是 32 结算金额，起结金额必须大于等于1 1.00
payBankList num String 是 32 支付类型编号（参见1.5） 10031414639876930831001
rate String 是 32 费率（参见1.5） 0.38
accountType String 否 是 账户类型，PUBLIC(对公)/PRIVATE(对私) PUBLIC
phone String 是 32 银行预留手机号 18201223907
privateType String 对私时必填 32 个体和个人 个人PERSON,个体INDIVIDUAL
settlerCertificateCode String 否 32 结算人身份证号 230604199304163012
settlerCertificateStartDate String 否 32 结算人身份证开始时间 2017-11-11
settlerCertificateEndDate String 否 32 结算人身份证结束时间 2018-11-11

请求JSON示例值：

  • JSON示例
  • 1 {
    2 "settleNum": "10051514750484432790012",
    3 "customerNum": "10001114749829775330009",
    4 "bankAccountName": "哆啦宝",
    5 "bankAccountNum": "2323232323232323",
    6 "province": "北京",
    7 "city": "北京",
    8 "bankBranchName": "招商银行北京分行",
    9 "bankName": "招商银行",
    10 "phone": "18201223908",
    11 "settleAmount": "1.00",
    12 "payBankList": [
    13 {
    14 "num": "10031414639876930831001",
    15 "rate": "0.38"
    16 }，
    17 {
    18 "num": "10031414639876930831004",
    19 "rate": "0.38"
    20 }，
    21 {
    22 "num": "10031414639876930831005",
    23 "rate": "0.38"
    24 }
    25 ]
    26 "accountType": "PRIVATE",
    27 "settlerCertificateCode": "230604199304163012",
    28 "settlerCertificateStartDate": "2017-11-11",
    29 "settlerCertificateEndDate": "2018-11-11"
    30 }

返回参数JSON格式：

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
settleNum String 是 32 结算编码 10051514750484432790012

响应JSON示例：

  • JSON示例
  • 1 {
    2 "data": {
    3 "settleNum": "10051514750484432790012"
    4 },
    5 "result": "success"
    6 }

查询结算信息接口：

GET请求地址：

环境 https请求地址
正式环境 https://openapi.duolabao.com/v1/agent/declare/settleinfo/{商户编号}
示例值 https://openapi.duolabao.com/v1/agent/declare/settleinfo/10001114745491441190171

返回参数JSON格式：

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
accountType String 是 32 账户类型，PUBLIC(对公)/PRIVATE(对私) PUBLIC
bankAccountName String 是 32 银行账户名称 哆啦宝
bankAccountNum String 否 32 银行账户编号 2323232323232323
bankBranchName String 是 32 银行分行名称 招商银行北京分行
bankName String 是 32 银行名称 招商银行
city String 是 32 所属城市 北京
province String 是 32 所属省份 北京
settleAmount String 是 32 结算金额，起结金额必须大于等于1 1.00
settleNum String 是 32 结算编号 47562614746223123560130
status String 是 32 结算状态 INIT(未审核)/OPEN(已开通)/CLOSE(已关闭); OPEN
phone String 是 32 银行预留手机号 18201223907
privateType String 对私时必填 32 个体和个人 个人PERSON,个体INDIVIDUAL
settlerCertificateCode String 否 32 结算人身份证号 230604199304163012
settlerCertificateStartDate String 否 32 结算人身份证开始时间 2017-11-11
settlerCertificateEndDate String 否 32 结算人身份证结束时间 2018-11-11

返回JSON示例：

  • JSON示例
  • 1 {
    2 "data": {
    3 "accountType": "PUBLIC",
    4 "bankAccountName": "哆啦宝",
    5 "bankAccountNum": "2323232323232323",
    6 "bankBranchName": "招商银行北京分行",
    7 "bankName": "招商银行",
    8 "city": "北京",
    9 "customerNum": "10001114745491441190171",
    10 "phone": "18201223908",
    11 "hasAttach": true,
    12 "province": "北京",
    13 "settleAmount": "1.00",
    14 "settleNum": "47562614746223123560130",
    15 "status": "OPEN",
    16 "privateType": "PERSON",
    17 "settlerCertificateCode": "230604199304163012",
    18 "settlerCertificateStartDate": "2017-11-11",
    19 "settlerCertificateEndDate": "2018-11-11"
    20 },
    21 "result": "success"
    22 }

错误码解释：

错误码 错误描述 解决方案
invalidBank banBranchName invalid 银行无效
invalidAmount amount invalid 金额无效
settleInfoExist settle exsit 结算信息已存在
customerFeeExsit customerFee exist 商户费率信息已经存在
settleInfoNotExsit settle not exsit 结算信息不存在
declareNotExsit declare not exsit 报单不存在
declareStatusError notaudit or pass 报单状态有误
uploadFail upload image fail 上传图片失败

平台热线：400-088-8816 工作日：周一至周五 9:00—18:00

哆啦宝（北京）科技有限公司

Copyright © 2016 Duolabao. All Rights Reserved. 京ICP备15047477号-2 网站支持IPV6