/app/bankaccount

给指定用户添加一个指定币种的银行账号。

本接口用于提交用户银行账户信息以完成出金操作。请求参数结构需严格遵循 /app/bankaccount/fields 接口返回的字段要求。

请求参数

请求体格式application/json 示例如下

{
  "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"
  }
}

参数说明

字段类型必填说明
uidstring用户唯一标识符
paramsobject银行账户参数集合

params 对象字段说明

字段类型必填说明
currencystring币种代码(如:EUR)
account_namestring账户持有人姓名
recipient_addressstring收款人地址
bank_countrystring银行所在国家代码
ibanstring国际银行账户号码
payment_methodstring支付方式:FPS/SEPA/WIRE/SWIFT。若提供,系统将基于此方式验证银行字段
swift_bicstringSWIFT/BIC 代码

重要提示

  1. 参数来源:所有 params 中的字段必须来源于 /app/bankaccount/fields 接口的响应数据
  2. 币种相关字段:请确保已包含该币种要求的所有必填字段
  3. 支付方式:仅当在 /app/withdrawmethods API 中选择了 FPS/SEPA/WIRE/SWIFT 时,才需要添加 payment_method 字段
  4. 字段验证:若提供 payment_method,系统将基于指定的支付方式进行银行字段验证
Query Params
string
required

user id

json
required
Defaults to {}

例如: { "bank_account_number":"123456789123", "account_name":"test_bank_account_name"}

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json