- 公共请求参数
- 公共返回结果
- 接口说明模板
- app-user
- 用户相关接口
- KYC税务表单接口
- 工单相关接口
- 沟通记录相关接口
- 审核相关接口
- KYC资料相关接口
- 通行证相关接口
- 风险等级测评接口
- 银行卡相关接口
- 大额投资者认证接口
- 零售客户行情订阅相关接口
- app-client
- 用户相关接口
- 审核相关接口
- 工单相关接口
- KYC税务表单接口
- 沟通记录相关接口
- KYC资料相关接口（临时保存）
- 通行证相关接口
- 风险等级测评接口
- 银行卡相关接口
- 大额投资者认证接口
- 零售客户行情订阅相关接口
- 交易系统相关接口
- 券商注册
- app-control
- app-report
- app-trading
- app-common
- app-platform
- app-notice
- app-storage
- app-public-fund
- app-order
- app-settle
- app-fund
- notification-center
- app-setting
- app-geography
创建存取款信息
开发中
POST
/client/v2/bankcard
接口变更记录#
| 变更版本 | 变更时间 | 变更人 | 变更内容 | 备注 |
|---|---|---|---|---|
| 客户模块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 | 银行账号不唯一 |
请求结构#
1.
2.
公共参数#
签名方法#
1.
公共返回结果#
接口描述#
1.
接口压测#
| 实际并发数 | 实际RT | 实际TPS | 频率限制次数（次/秒） |
|---|---|---|---|
| 无 |
请求参数
Body 参数application/json
uuid
string
客户UUID
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
货币类型
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": "voucher_123456"
}示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/client/v2/bankcard' \
--header 'Content-Type: application/json' \
--data-raw '{
"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": "voucher_123456"
}'返回响应
🟢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
审核状态
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"
}