创建存取款信息

接口变更记录

变更版本	变更时间	变更人	变更内容	备注
客户模块V1.9.0	2025-04-29	fain mo	上线

错误码

code	msg	msg_cn
200207	Failed to obtain user information, user does not exist!	获取用户信息失败，用户不存在
200220	user status error!	用户状态异常
201207	operator uuid does not equal customer uuid!	操作人uuid不等于客户uuid
200605	bank list query failed	银行列表查询失败
200606	bank information does not exist	银行信息不存在
200607	bank information not enabled	银行信息未启用
890001	Database query failed	Database query failed
200608	Only the customer's own bank card can be added	仅支持添加客户本人银行卡
990001	parameter validation exception	入参校验异常
200609	bank account number is not unique	银行账号不唯一

请求结构

通信协议：Http、Https

字符编码：UTF-8

公共参数

https://app.apifox.com/link/project/3192700/apis/doc-2903487

签名方法

暂无

公共返回结果

https://app.apifox.com/link/project/3192700/apis/doc-2903489

接口描述

接口压测

（参考测试提供的压测结果）

实际并发数	实际RT	实际TPS	频率限制次数（次/秒）
			无

请求参数

Body 参数application/json

uuid

string

客户UUID

必需

1122122121221

initiation_type

string

发起方式

必需

operator

string

发起人

必需

bank_country

string

银行所在国家/地区

必需

bank_address_details

string

银行详细地址

可选

bank_mark

string

银行账户所属银行

必需

bank_name

string

银行名称

可选

username

string

账户姓名

必需

bank_card

string

银行账号

必需

currency

string

货币类型

必需

单币种：具体的币种
多币种：MUTI-CURRENCY

bank_branch

string

银行支行名称

可选

clearing_mark

string

银行识别码

可选

swift

string

SWIFT

可选

user_address

string

联系地址

可选

account_voucher

string

银行凭证

必需

示例

{
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "initiation_type": "client",
  "operator": "john_doe",
  "bank_country": "US",
  "bank_address_details": "123 Main St, New York",
  "bank_mark": "CITIUS33",
  "bank_name": "Citibank",
  "username": "Jane Smith",
  "bank_card": "6225880123456789",
  "currency": "USD",
  "bank_branch": "Downtown Branch",
  "clearing_mark": "123456",
  "swift": "CITIUS33XXX",
  "user_address": "456 Oak Ave, Los Angeles",
  "account_voucher": "[{\"name\":\"beautiful-landscape-mother-nature.bmp\",\"fileLink\":\"/storage/download/sc-eix9-judwbf1g0.bmp\",\"url\":\"/storage/download/sc-eix9-judwbf1g0.bmp\"},{\"name\":\"beautiful-landscape-mother-nature.jpg\",\"fileLink\":\"/storage/download/sc-6iyr-2toqfud9z.jpg\",\"url\":\"/storage/download/sc-6iyr-2toqfud9z.jpg\"},{\"name\":\"Snipaste_2023-11-29_11-19-15.png\",\"fileLink\":\"/storage/download/sc-1fnl-wkrbl0bsr.png\",\"url\":\"/storage/download/sc-1fnl-wkrbl0bsr.png\"}]"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

必需

success

boolean

必需

data

object

必需

bank_id

string

银行信息唯一标识

必需

type

string

类型

必需

uuid

string

客户uuid

必需

appid

string

租户id

必需

username

string

开户名称

必需

bank_name

string

银行名称

必需

bank_branch

string

具体支行名称

必需

bank_country

string

具体支行所在国家

必需

bank_city

string

开户支行城市

必需

bank_province

string

开户支行省

必需

bank_card

string

银行账号

必需

currency

string

货币

必需

swift

string

SWIFT

必需

user_address

string

收款人地址

必需

addtime

string

创建时间

必需

verify_status

integer

认证状态（默认0，大陆银行卡认证后为1）

必需

remark

string

备注

必需

deleted

string

是否删除

必需

intermediary_bank_name

string

中转银行名称

必需

intermediary_bank_address

string

中转银行地址

必需

intermediary_bank_swift

string

中转银行SWIFT

必需

intermediary_bank_account

string

中转银行账号

必需

intermediary_bank_remark

string

中转银行备注

必需

clearing_mark

string

清算标识

必需

document_num

string

证件号码

必需

bank_mark

string

银行唯一标识

必需

operator

string

发起人

必需

bank_address_details

string

银行详细地址

必需

account_voucher

string

银行凭证

必需

initiation_type

string

发起方式

必需

status

string

审核状态

必需

待修改 MODIFY
审核中 AUDITING
审核通过 PASS

audit_time

string

审核时间

必需

update_time

string

修改时间

必需

msg

string

必需

traceId

string

必需

示例

{
  "bank_id": "B123456789",
  "type": "savings",
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "appid": "APP123456",
  "username": "Jane Smith",
  "bank_name": "Citibank",
  "bank_branch": "Downtown Branch",
  "bank_country": "US",
  "bank_city": "New York",
  "bank_province": "NY",
  "bank_card": "6225880123456789",
  "currency": "USD",
  "swift": "CITIUS33XXX",
  "user_address": "456 Oak Ave, Los Angeles",
  "addtime": "2023-01-01 10:00:00",
  "verify_status": 1,
  "remark": "VIP customer",
  "deleted": "0",
  "intermediary_bank_name": "Bank of America",
  "intermediary_bank_address": "789 Pine Rd, Chicago",
  "intermediary_bank_swift": "BOFAUS3N",
  "intermediary_bank_account": "987654321",
  "intermediary_bank_remark": "Intermediary for international transfers",
  "clearing_mark": "BSS123",
  "document_num": "DOC456",
  "bank_mark": "CITIUS33",
  "operator": "john_doe",
  "bank_address_details": "123 Main St, New York",
  "account_voucher": "voucher_123456",
  "initiation_type": "client",
  "status": "active",
  "audit_time": "2023-01-02 14:30:00",
  "update_time": "2023-01-03 09:15:00"
}

创建存取款信息

接口变更记录#

错误码#

请求结构#

公共参数#

签名方法#

公共返回结果#

接口描述#

接口压测#

请求参数

示例代码

返回响应

接口变更记录

错误码

请求结构

公共参数

签名方法

公共返回结果

接口描述

接口压测