post
https://sandboxapi.legendtrading.com/app/bankaccount
给指定用户添加一个指定币种的银行账号。
本接口用于提交用户银行账户信息以完成出金操作。
params 内的字段并非固定，而是随币种（以及可选的支付方式）变化，权威来源是 /app/bankaccount/fields 针对该币种返回的结果。请先调用 /app/bankaccount/fields，按其返回的 name 渲染表单，再以相同的 name 提交到 params。
请求参数
请求体格式：application/json 示例如下（EUR，payment_method: SEPA）
{
"uid": "qa159165",
"params": {
"currency": "EUR",
"account_name": "Piero Ventura junco",
"recipient_address": "Calle Caramanta",
"bank_country": "ES",
"iban": "ES23 0049 5525 5321 1203 7931",
"payment_method": "SEPA",
"swift_bic": "123"
}
}同一接口在 USD 下会返回不同的字段集（bank_swift、routing_number 等，而非 iban / swift_bic），因此上述示例不是通用模板——字段清单请一律以 /app/bankaccount/fields 的返回为准。
参数说明
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
uid | string | 是 | 用户唯一标识符 |
params | object | 是 | 银行账户参数集合 |
params 对象字段说明
params 对象字段说明仅下列字段为恒必填；params 中的其余字段均为币种相关，须取自 /app/bankaccount/fields 的返回结果。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
currency | string | 是 | 币种代码（如：EUR、USD） |
account_name | string | 是 | 账户持有人姓名 |
bank_country | string | 是 | 银行所在国家代码或名称 |
payment_method | string | 否 | 支付方式：FPS / SEPA / WIRE / SWIFT。仅当在 /app/withdrawmethods 中选择了对应方式时才传 |
... | — | — | 其余字段（如 iban、swift_bic、bank_swift、routing_number、bank_account_number、sort_code、bsb_number 等）均随币种变化——请使用 /app/bankaccount/fields 返回的 name |
重要提示
- 参数来源：
params中的每个字段都必须来源于/app/bankaccount/fields接口的响应数据。字段名因币种而异——不要把某一币种的字段清单套用到另一币种。 - 字段名：请原样提交
/app/bankaccount/fields返回的每个name。改名或翻译字段名会导致该值被丢弃。 - 支付方式：仅当在
/app/withdrawmethodsAPI 中选择了FPS/SEPA/WIRE/SWIFT时，才需要添加payment_method字段。