← 返回 BeeX 文档导航
Xendit Disbursement Channels

Xendit 可出款银行与渠道目录

说明 XenditDisbursementClient.listAvailableBanks() 返回什么、BeeX 如何使用渠道码,以及印尼测试账号当前真实返回的 156 个可出款渠道。
版本 v1.0 更新于 2026-07-16 数据来源:Xendit id-test 实际响应 适用国家:Indonesia
实际返回渠道156
可出款156
支持户名校验156
本地缓存时间6 小时

一、结论

是,可以用于选择给用户转账的收款渠道。
这个方法调用 Xendit GET /available_disbursements_banks,返回当前 Xendit 账号可通过旧版 Disbursement API 使用的渠道。前端显示 name,提交时必须保存和传递 code

银行提现:选择列表里的渠道,例如 BCA,出款时作为 bank_code 传给 POST /disbursements

返回字段:codenamecan_disbursecan_name_validate

BeeX App 接口:GET /api/v1/withdraw/banks?countryCode=ID,需要用户登录。

二、BeeX 调用链

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
      

三、银行与电子钱包边界

不要把这份列表的电子钱包 code 直接用于 v2 Payouts。
这份接口会返回 DANAOVOGOPAY 等旧版渠道码;BeeX 电子钱包出款走 POST /v2/payouts 时,代码要求的是 ID_DANAID_OVOchannel_code。两套 code 不能混用。
场景Xendit 接口字段示例
银行账户出款POST /disbursementsbank_codeBCA
电子钱包出款POST /v2/payoutschannel_codeID_OVO

四、完整渠道目录

#Xendit code显示名称类型可出款户名校验操作
没有匹配的渠道

五、当前实现与注意事项

  • WithdrawBankCatalog 缓存 Xendit 列表 6 小时;Xendit 调用失败时使用上一次缓存,没有缓存时回退到 12 家主要印尼银行。
  • 当前真实响应的 156 项全部是 can_disburse=true,但前端仍应只展示可出款项,避免未来 Xendit 临时关闭渠道时继续让用户选择。
  • 当前 /api/v1/withdraw/banks 虽接收 countryCode,服务实现暂未按国家筛选;马来环境上线前必须拆分国家目录和币种。
  • 部分名称带 formerly,是 Xendit 原始返回的历史兼容名称,不代表应该在 App 首页优先展示。建议常用银行置顶,其余支持搜索。
  • 正式环境应使用正式 Xendit 账号重新拉取一次,不能默认认为测试账号与正式账号列表永久一致。