XenditDisbursementClient.listAvailableBanks() 返回什么、BeeX 如何使用渠道码,以及印尼测试账号当前真实返回的 156 个可出款渠道。GET /available_disbursements_banks,返回当前 Xendit 账号可通过旧版 Disbursement API 使用的渠道。前端显示 name,提交时必须保存和传递 code。
银行提现:选择列表里的渠道,例如 BCA,出款时作为 bank_code 传给 POST /disbursements。
返回字段:code、name、can_disburse、can_name_validate。
BeeX App 接口:GET /api/v1/withdraw/banks?countryCode=ID,需要用户登录。
sequenceDiagram
participant App as BeeX App / H5
participant API as BeeX API
participant Catalog as WithdrawBankCatalog
participant Xendit as Xendit
App->>API: GET /api/v1/withdraw/banks?countryCode=ID
API->>Catalog: list()
alt 6 小时缓存有效
Catalog-->>API: 返回缓存渠道
else 缓存失效
Catalog->>Xendit: GET /available_disbursements_banks
Xendit-->>Catalog: code / name / can_disburse / can_name_validate
Catalog-->>API: 缓存并返回渠道
end
API-->>App: 渠道列表
App->>API: 提交提现,携带 bank_code
API->>Xendit: POST /disbursements
DANA、OVO、GOPAY 等旧版渠道码;BeeX 电子钱包出款走 POST /v2/payouts 时,代码要求的是 ID_DANA、ID_OVO 等 channel_code。两套 code 不能混用。
| 场景 | Xendit 接口 | 字段 | 示例 |
|---|---|---|---|
| 银行账户出款 | POST /disbursements | bank_code | BCA |
| 电子钱包出款 | POST /v2/payouts | channel_code | ID_OVO |
| # | Xendit code | 显示名称 | 类型 | 可出款 | 户名校验 | 操作 |
|---|
WithdrawBankCatalog 缓存 Xendit 列表 6 小时;Xendit 调用失败时使用上一次缓存,没有缓存时回退到 12 家主要印尼银行。can_disburse=true,但前端仍应只展示可出款项,避免未来 Xendit 临时关闭渠道时继续让用户选择。/api/v1/withdraw/banks 虽接收 countryCode,服务实现暂未按国家筛选;马来环境上线前必须拆分国家目录和币种。formerly,是 Xendit 原始返回的历史兼容名称,不代表应该在 App 首页优先展示。建议常用银行置顶,其余支持搜索。