# 账户开户接口
# 说明
- 该接口适用于余额支付分账
- 支持对公或对私
# 接口地址
https://open.weidoufu.com/funds/receiver (opens new window)
请求方式：POST
# 接口参数
| 名称 | 类型 | 必填参数 | 说明 （AccessKey/SecretKey）应用密钥 |
|---|---|---|---|
| access_key | string(32) | 是 | 应用密钥的 AK，即是 AccessKey |
| receiver_name | string(32) | 是 | 收款人姓名（对公为公司全称） |
| receiver_type | int(1) | 是 | 业务类别（1-对私；3-对公） |
| idcard_no | string(32) | 是 | 收款人身份证号码（对公为营业执照统一编码） |
| mobile_no | string(11) | 是 | 收款人手机号码 |
| begin_date | string(16) | 是 | 身份证有效期开始日期，格式 YYYY-MM-DD |
| end_date | string(16) | 是 | 身份证有效期截止日期（长期填写 9999-12-31） |
| bank_no | string(32) | 是 | 结算银行卡号 （对公为对公账户） |
| bank_code | string(10) | 选（对公） | 结算银行编码（对公必填） |
| bank_name | string(32) | 选（对公） | 结算银行全称，含支行（对公必填） |
| province_code | string(8) | 是 | 结算银行省份编码 |
| city_code | string(8) | 是 | 结算银行城市编码 |
| step_mode | int(1) | 否 | 开户模式（1-同步），需注意接口超时时间 |
| sign | string | 是 | 签名结果（大写），详见 签名算法 (opens new window) |
温馨提示：
- 请注意对公账户必填想，对私可不填
# 返回参数
返回为 json 格式
| 名称 | 字段类型 | 必有 | 说明 |
|---|---|---|---|
| code | int | 是 | 1：成功 0：失败 |
| message | string | 是 | 返回描述信息 |
| data | object | 是 | 返回数据 |
返回数据的 data 字段介绍
| 名称 | 字段类型 | 必有 | 说明 |
|---|---|---|---|
| idcard_no | string | 是 | 收款人身份证号码 |
| merchant_no | string | 是 | 当前关联商户号 |
| mobile_no | string | 是 | 收款人手机号码 |
| receiver_code | string | 是 | 收款人编码（重要，BK 开头） |
| receiver_name | string | 是 | 收款人姓名 |
重要提示：
- receiver_code 字段需要自行保存，在发起结算请求需要用到
成功返回结果:
{
code: 1,
data: {
idcard_no: '310225199501012018',
merchant_no: 'EM2023052132480',
mobile_no: '13800138000',
receiver_code: 'BK2310181202929528',
receiver_name: '张三',
},
message: "操作成功",
status: "success"
}
失败返回结果:
{
code: 0,
data: '',
message: "对公需要开户银行编号",
status: "fail"
}
最后更新于: 1/4/2024, 11:25:21 PM