Callback 事件列表

Callback 事件規則¶

Callback 事件預計平均會在 1 到 5 分鐘後送達，但理論上可能需要長達 24 小時。

如果由於某些原因合作方錯過了 Callback 事件，請不要擔心：系統會記錄嘗試發送的所有內容，並且可以隨時重新發送失敗的 Callback 事件。

如果 Callback 事件請求失敗，系統會嘗試重新發送 5 次：1 分鐘、5 分鐘、1 小時、 5 小時和 18 小時後，直到請求成功取得 2xx 狀態碼。

用戶帳號狀態變化事件¶

當用戶的帳號狀態發生變化時，系統會將狀態變化事件內容發送至合作方提供的對應此事件的 Webhook URL。

事件內容¶

{
    "account_uuid": "6d92e7b4-715c-4ce3-a028-19f1c8c9fa6c",
    "user_ext_ref": "fce4fd45-7dd7-4d4c-b06c-e17ff12f3e30",
    "status": "INITIALIZED",
    "event_time": "2020-07-01T09:00:00.000Z"
}

參數	類型	說明
`account_uuid`	string	Cabital 提供的帳號 ID
`user_ext_ref`	string	合作方提供的帳號 ID
`status`	string	帳號綁定狀態，各狀態說明請參閱下方帳號綁定狀態表
`event_time`	string	事件發生的時間，格式為 ISO 8601

帳號綁定狀態表¶

狀態值	說明
`INITIALIZED`	用戶成功綁定，用戶尚未在 Cabital 進行實名認證流程
`PENDING`	Cabital 處理用戶實名認證資料中
`TEMPORARY_REJECTED`	用戶被 Cabital 要求重新提供正確實名認證資料
`FINAL_REJECTED`	用戶被 Cabital 拒絕開戶
`CREATED`	用戶實名認證通過並帳戶開通，待合作方提交同名認證
`MATCHING`	Cabital 人工審查同名認證中
`MATCHED`	用戶同名認證成功
`MISMATCHED`	用戶同名認證失敗
`UNLINKED`	用戶或 Cabital 已主動解除與合作方的綁定

用戶各狀態解除綁定後再綁定狀態變化表¶

狀態值	狀態變化	備註
`INITIALIZED`	`UNLINKED` → `INITIALIZED`
`PENDING`	`UNLINKED` → `INITIALIZED` → `PENDING`
`TEMPORARY_REJECTED`	`UNLINKED` → `INITIALIZED` → `TEMPORARY_REJECTED`
`FINAL_REJECTED`	`UNLINKED` → `INITIALIZED` → `FINAL_REJECTED`
`CREATED`	`UNLINKED` → `INITIALIZED` → `CREATED`
`MATCHED`	`UNLINKED` → `INITIALIZED` → `CREATED`	須重新進行用户實名認證資料 KYC Acceptance 或同名認證 KYC Match
`MISMATCHED`	`UNLINKED` → `INITIALIZED` → `CREATED`	須重新進行用户實名認證資料 KYC Acceptance 或同名認證 KYC Match

用戶帳號轉帳交易狀態變化事件¶

當合作方或用戶的發起轉帳時，系統會將狀態變化事件內容發送至合作方提供的對應此事件的 Webhook URL。

合作方收到此事件內容後，可透過 account_id 、 transfer_id 並請求對應 API 取得該筆轉帳交易詳細資訊

account_id：以帳號 ID 查詢轉帳交易列表
transfer_id：以轉帳交易 ID 取得單一轉帳交易詳細資訊

事件內容¶

{
  "transfer_id": "16d4dfe2-de1b-4ceb-b1d8-8b9b79a3200b",
  "external_id": "c02aa167-ef1a-44bf-8bdb-1da805479013",
  "account_uuid": "1771ffd6-d20b-4858-ad34-d596a9ec51d4",
  "user_ext_ref":"fce4fd45-7dd7-4d4c-b06c-e17ff12f3e30",
  "direction": "DEBIT",
  "transfer_by": "CUSTOMER",
  "symbol":"USDT",
  "instructed_amount":"36.437294",
  "customer_fee":"0.99",
  "actual_amount":"35.447294",
  "status": "SUCCESS",
  "event_time": "2022-04-01T09:00:00.000Z"
}

參數	類型	說明
`transfer_id`	string	轉帳交易 ID
`external_id`	string	合作方提供的交易 ID
`account_uuid`	string	Cabital 提供的帳號 ID
`user_ext_ref`	string	合作方提供的帳號 ID
`direction`	string	轉帳交易的方向，以 Cabital 為中心的資金流向： `CREDIT`：合作方 → Cabital `DEBIT`：Cabital → 合作方
`transfer_by`	string	轉帳交易的發起方 `PARTNER`：合作方 `CUSTOMER`：用戶
`symbol`	string	轉帳交易的幣種
`instructed_amount`	string	轉帳交易的金額（含手續費）
`customer_fee`	string	收取用戶的轉帳手續費
`actual_amount`	string	轉帳交易扣除手續費的金額
`status`	string	轉帳交易的狀態 `PROCESSING`：轉帳交易對帳中 `SUCCESS`：轉帳交易成功 `FAILED`：轉帳交易失敗 `CANCEL`：轉帳交易已取消
`event_time`	string	事件發生的時間，格式為 ISO 8601