IBAN详情接口
说明：获取单条 IBAN 详情
生产环境 API URL：#/api/iban/detail
测试环境 API URL：https://ibantest.yabandpay.com/api/iban/detail
Method：POST
Header：
Authorization: Bearer {api_account_token}
Content-Type: application/json
1. 请求参数（顶层）
| 字段 | 类型 | 描述 | 是否必填 |
|---|---|---|---|
| uid | string | API 账户 UID（对应 iban_api_account.uid） | 必填 |
| timestamp | integer | 请求时间戳（秒） | 必填 |
| nonce | string | 随机字符串，防重放 | 必填 |
| sign | string | 签名 | 必填 |
| data | object | 查询条件集 | 必填 |
2. data 对象（支持写在顶层或 data 内）
| Parameter | Type | Description | 是否必填 |
|---|---|---|---|
| request_id | string | 请求号，响应原样回传 | 非必填 |
| id | integer | IBAN 记录 ID | 必填 |
权限隔离：只能查询到
api_account_id = 当前账户ID的记录，否则直接返回-3001 IBAN record not found（不暴露是否存在）。
3. 提交示例
{
"uid": "900001",
"timestamp": 1750000000,
"nonce": "Qe3CkH2xP8",
"sign": "A1AC665F9B40F7C51212BCE080F5B987",
"data": {
"request_id": "req_20260820_detail_001",
"id": 1,
"timezone": "Asia/Shanghai"
}
}
4. 返回示例
成功
{
"status": true,
"code": 200,
"message": "",
"data": {
"id": 1,
"customer_type": "legal_entity",
"customer_id": "2012345678",
"holder_name": "企业名字",
"alternative_name": "First_name Last_name",
"creditor_identifier": "NL00ZZZ123456780000",
"bic": "YABNNL22",
"iban": "NL09YABN0192150222",
"currency": "EUR",
"balance": "1000.00",
"access": 1,
"access_label": "full",
"status": 1,
"status_label": "active",
"remark": "测试备注",
"api_account_id": 1,
"created_at": 1784851200,
"updated_at": 1784851800,
"request_id": "req_20260820_detail_001"
}
}
失败：记录不存在 / 不属于当前账户
{
"status": false,
"code": -3001,
"message": "IBAN record not found",
"data": {}
}
失败：缺少 id
{
"status": false,
"code": -3002,
"message": "The given data was invalid.",
"data": {}
}