获取法币收款信息
本接口用于获取特定法币对应的平台收款银行账户详情及用户的充值参考代码。
根据用户及币种情况，返回的账户为 vIBAN（专属虚拟 IBAN）或 Legend 的 Pooled Account（共享银行账户）之一，由系统自动分配——详见下方「账户类型」与「常见问题」部分。
核心规则
-
账户隔离原则
Legend 平台为每种法币使用独立的银行账户。 -
Reference Code 使用规则
当返回的是 Pooled Account 时，返回数据中的reference_code至关重要。用户发起电汇时，必须将此Code填写在“附加信息”或“备注”栏中。该代码是我们识别汇款来源的关键凭证，缺少Reference Code将导致无法确认款项归属。（vIBAN 返回的reference_code为空——专属虚拟 IBAN 本身即可识别用户。） -
字段动态展示
不同币种的银行账户信息字段可能不同，必须向用户完整展示接口返回的所有字段。
示例：GBP（英镑）账户包含独有的 "Sort Code"（分类代码）字段，其他币种则无此字段。 -
Reference Code唯一性
用户的Reference Code在其所有法币交易中保持不变。
返回值说明
| 字段名称 | 描述 | 示例 | 类型 |
|---|---|---|---|
| deposit_account | 银行账户的全部信息字段。请注意，不同法币对应的字段可能不同，请务必在您的网页上正确显示。 例如： "Sort Code": "040541" "BIC": "BCPYGB22" "IBAN": "GB29 BCPY 040541 00003326" 关键提示： 1.需根据用户选择的币种动态显示对应字段 2.字段名称与格式需严格遵循接口返回数据 3.避免混淆BIC与SWIFT代码的表述 | Check the response code 200's example, 详见200的返回字段。 | JSON |
| reference_code | 用于入金核对的唯一识别码，Legend 据此识别汇款人。Pooled Account 入金必填——用户必须在汇款备注/附言栏填写此码。返回 vIBAN 时（符合条件的 EEA 用户以 EUR 入金）该字段为空，因为专属虚拟 IBAN 本身即可识别用户 | ZGAEIXS | string |
| asset_fiat | fiat 资产类型，通常是法币(fiat) | USD, EUR, GBP... | string |
| transfer_type | transfer type 汇款类型 | wire | string |
| is_virtual_account | 返回的账户是否为 vIBAN。true = vIBAN（专属虚拟 IBAN，自动分配给以 EUR 入金的符合条件的 EEA 用户）；false = Pooled Account（Legend 共享银行账户） | true | boolean |
账户类型：vIBAN 与 Pooled Account
| vIBAN | Pooled Account | |
|---|---|---|
| 分配对象 | 符合条件的 EEA 用户以 EUR 入金——首次请求时系统自动创建专属虚拟 IBAN | 其他所有用户及币种 |
is_virtual_account | true | false |
reference_code | 为空——无需填写，专属虚拟 IBAN 本身即可识别用户 | 返回且必填——用户必须在汇款备注/附言栏填写此码 |
| 入金匹配方式 | 按用户专属虚拟 IBAN 匹配 | 按 reference_code 匹配 |
账户类型由系统自动判断和分配，终端用户无法手动选择。
常见问题
1. vIBAN 和 Pooled Account 需要分别接两个 API 吗？
不需要。只需要集成这一个 Deposit Account API（GET /app/depositaccount），系统会根据用户情况自动返回 vIBAN 或 Pooled Account。
2. 什么情况下会返回 vIBAN？
符合条件的 EEA 用户使用 EUR 入金时，系统会自动创建并返回 vIBAN。其他不符合 vIBAN 条件的用户，会返回 Legend 的 Pooled Account。
3. Pooled Account 如何识别不同用户的入金？
使用 reference_code。如果返回的是 Pooled Account，用户转账时必须在汇款备注中填写 API 返回的 reference_code，Legend 会通过该 reference_code 匹配对应用户。
4. 用户可以自己选择 vIBAN 或 Pooled Account 吗？
不可以。账户类型由系统自动判断和分配，用户无法手动选择。合作方只需要调用 Deposit Account API，并展示 API 返回的入金信息即可。
5. 虚拟 IBAN 由谁签发？
虚拟 IBAN 由我们的银行合作方 Banking Circle 签发。Legend 提供集成层，Banking Circle 是该专用账户背后的签发银行合作方。