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

需要授权

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

保存结算信息请求接口:

POST请求地址:

环境 https请求地址
正式环境 https://openapi.duolabao.cn/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

请求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 }

返回参数JSON格式:

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

响应JSON示例:

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

修改结算信息请求接口:

POST请求地址:

环境 https请求地址
正式环境 https://openapi.duolabao.cn/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

请求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 }

返回参数JSON格式:

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

响应JSON示例:

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

查询结算信息接口:

GET请求地址:

环境 https请求地址
正式环境 https://openapi.duolabao.cn/v1/agent/declare/settleinfo/{商户编号}
示例值 https://openapi.duolabao.cn/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

返回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 },
    18 "result": "success"
    19 }