提现银行（Withdraw Bank）接入文档

一、说明

提现银行用于配置用户提现时可选的银行 / 钱包，以及每个银行在各代付渠道（jaya / unispay / futurepay）下的代付银行码与限额。

数据分两张表：

• 主表 withdraw_banks：面向用户展示的银行 / 钱包（名字、类型、排序、启停）。
• 渠道映射表 withdraw_bank_channels：每行 = 某代付渠道下的一个银行码，关联到主表银行（bank_id），并带单笔 min/max 限额。bank_id=0 表示该目录行尚未映射到主表银行。

接入方分两类：

• 用户端（App / H5）：只读，获取「提现可选银行列表」。
• 管理后台：对主表和渠道映射做完整 CRUD，以及「整体替换某银行的渠道关联」。

通用约定

• 所有接口均为 HTTP POST，请求 / 响应体为 JSON。
• 统一响应外层包裹： json { "code": 200, "message": "success", "data": { ... } } code=200 为成功，data 为各接口的响应体；失败时 code 为业务错误码、message 为提示，data 为 null。
• 空响应（create/update/delete）成功时 data 为 {}。
• 金额单位为 IDR（印尼盾）整数；min_amount / max_amount 为 0 表示不限。
• 枚举在 JSON 中可传字符串名（如 "TYPE_BANK"）或数字值（如 1），响应默认返回字符串名。

鉴权头

二、用户端接口

1. 获取提现可选银行 / 钱包列表

• POST /v1/user/withdraw/bank/list
• 请求体：{}（无参数）
• 仅返回启用的主表银行；排序：钱包在前，同类按 sort 升序。

响应 data：

{
  "banks": [
    { "name": "DANA", "type": "e-wallet" },
    { "name": "BCA",  "type": "bank" }
  ]
}

字段说明：

用户选定 name 后走原有提现下单流程；后端按 name + 代付渠道查渠道映射拿到代付银行码与限额。

三、管理后台接口

A. 主表（银行 / 钱包）

1. 列表 — POST /v1/man/withdraw/bank/list

请求：

响应 data： { "total": 12, "banks": [ <WithdrawBank>, ... ] }（含各渠道映射 channels）

2. 新增 — POST /v1/man/withdraw/bank/create

响应 data：{}

3. 更新 — POST /v1/man/withdraw/bank/update

字段同 create，额外必填 id（int64，>0）。整体覆盖 name/type/sort/is_disabled。id 不存在返回未找到错误。响应 data：{}

4. 删除 — POST /v1/man/withdraw/bank/delete

删除主表银行，同时把其下渠道映射的 bank_id 置 0（保留在目录里，解除关联）。响应 data：{}

B. 渠道映射目录

5. 列表 — POST /v1/man/withdraw/bank/channel/list

响应 data： { "total": 30, "channels": [ <WithdrawBankChannel>, ... ] }

6. 新增 — POST /v1/man/withdraw/bank/channel/create

约束：同一银行在同一渠道下只能关联一条（bank_id>0 时校验，重复返回已存在错误）。响应 data：{}

7. 更新 — POST /v1/man/withdraw/bank/channel/update

字段同 create，额外必填 id（int64，>0）。同渠道同银行唯一校验（排除自身）。响应 data：{}

8. 删除 — POST /v1/man/withdraw/bank/channel/delete

id（int64，必填，>0）。物理删除该映射。响应 data：{}

9. 整体设置某银行的渠道关联 — POST /v1/man/withdraw/bank/channel/set

一次性替换某主表银行的全部渠道关联：先把该银行历史关联清掉（bank_id 置 0），再按传入项重建（命中目录行则改其 bank_id/限额，否则新建）。

响应 data：{}

四、模型字段说明

WithdrawBank（主表，后台列表/详情返回）

WithdrawBankChannel（渠道映射）

枚举

WithdrawBank.Type（银行类型）

用户端 type 字符串：银行卡=bank，钱包=e-wallet。

WithdrawBankChannel.Type（代付渠道）

五、接口一览