接口概覽
所有接口均使用 POST 方法,並在文件中定義了以下請求頭。簽名生成方式及簽名規則以接入方實際約定爲準;本文件僅提供欄位名稱和類型。
| 請求頭 | 類型 | 說明 |
| X-API-Key | string | 應用訪問標識 |
| X-Timestamp | integer | 請求時間戳 |
| X-Nonce | string | 請求隨機串 |
| X-Signature | string | 請求籤名 |
| Content-Type | string | application/json |
文件未定義統一的 securitySchemes 或 servers 配置;因此文檔只按各接口中實際聲明的請求頭描述,不額外推斷認證流程。
1.1 接口清單
| 模塊 | 方法 | 接口路徑 | 說明 |
| 主賬戶 | POST | /abc/v1/account/detail | 獲取主賬戶詳情 |
| 主賬戶 | POST | /abc/v1/account/transfer | 主賬戶管理:賬戶轉賬 |
| 主賬戶 | POST | /abc/v1/account/recharge-address | 獲取充值地址 |
| 主賬戶 | POST | /abc/v1/account/flow/query | 查詢主賬戶資金流水 |
| 主賬戶 | POST | /abc/v1/account/recharge/query | 查詢充值明細 |
| 子賬戶 | POST | /abc/v1/sub-account/create | 創建子賬戶 |
| 子賬戶 | POST | /abc/v1/sub-account/query | 子賬戶分頁查詢 |
| 子賬戶 | POST | /abc/v1/sub-account/detail | 子賬戶詳情 |
| 子賬戶 | POST | /abc/v1/sub-account/update-status | 啓停子賬戶 |
| 子賬戶 | POST | /abc/v1/sub-account/update-name | 修改子賬戶名稱 |
| 子賬戶 | POST | /abc/v1/sub-account/flow/query | 查詢子賬戶資金流水 |
| 子賬戶 | POST | /abc/v1/sub-account/switch-provider | 切換子賬戶卡渠道 |
| 預算 | POST | /abc/v1/budget/create | 創建預算 |
| 預算 | POST | /abc/v1/budget/query | 查詢預算列表 |
| 預算 | POST | /abc/v1/budget/update | 預算調額 |
| 預算 | POST | /abc/v1/budget/detail | 預算詳情 |
| 卡管理 | POST | /abc/v1/card/create | 同步創建單張虛擬卡(同步返回卡信息) |
| 卡管理 | POST | /abc/v1/card/query | 查詢卡列表 |
| 卡管理 | POST | /abc/v1/card/edit | 更新卡片(卡名稱 / 卡類型 / 限額) |
| 卡管理 | POST | /abc/v1/card/update-status | 更新虛擬卡狀態(啓用 / 禁用) |
| 卡管理 | POST | /abc/v1/card/detail | 查詢卡詳情 |
| 卡管理 | POST | /abc/v1/card/cancel | 卡管理:註銷卡片 |
| 卡管理 | POST | /abc/v1/card/bin/query | 查詢卡 BIN |
| 交易 | POST | /abc/v1/transaction/query | 查詢卡交易流水(分頁) |
| 交易 | POST | /abc/v1/transaction/detail | 根據交易流水號獲取單筆交易詳情 |
| 交易 | POST | /abc/v1/3ds-challenge/challenge | 提交 3DS Challenge 決定(先查狀態,再決定是否提交) |
| Webhook | POST | /open-api/v1/webhook/register | 創建 Webhook |
| Webhook | POST | /open-api/v1/webhook/query | 查詢 Webhook 配置(簽名密鑰脫敏) |
| Webhook | POST | /open-api/v1/webhook/disable | 停用 Webhook |
| Webhook | POST | /abc/v1/webhook/register | 創建 Webhook |
| Webhook | POST | /abc/v1/webhook/query | 查詢 Webhook 配置(簽名密鑰脫敏) |
| Webhook | POST | /abc/v1/webhook/disable | 停用 Webhook |