跳轉到

資金結算

合作夥伴可以透過 API 請求 (Direct Debit)，將用戶 Cabital 錢包轉帳至合作方平台，亦可由用戶在 Cabital Widget 上操作自行轉帳到合作方平台 (Transfer Debit)，無論哪一種轉帳類型，雙方平台都先為用戶進行墊付上帳，提供即時的用戶體驗。

Cabital 於每日日終進行清算，合作夥伴可以用不同的方式查閱對帳文件，並在約定時間結算應付或應收帳款，雙方再依約定收款地址進行支付結算款項。

轉帳的 3 種類型

  1. Direct debit：由合作夥伴發起，將資金從用戶 Cabital 帳號移轉至合作夥伴帳號，可適用於合作方帳號入金、消費等場景。
  2. Direct credit：由合作夥伴發起，將資金從合作夥伴帳號移轉至用戶 Cabital 帳號，可適用於合作夥伴帳號提現、退款、獎勵發放等場景。
  3. Transfer debit：由用戶在 Cabital 平台發起，將資金從用戶 Cabital 帳號移轉至合作夥伴帳號，在得到合作夥伴確認後，Cabital 才會扣減用戶帳戶餘額。

流程圖

 sequenceDiagram 
participant 用戶
participant Cabital 
participant 合作方

note over 用戶, 合作方: 轉帳交易流程
用戶 ->> 合作方: 操作轉帳功能
合作方 ->> Cabital: 請求轉帳
alt Direct Debit<br>轉帳至合作方
    Cabital->>用戶: 扣除帳戶餘額
    note right of 用戶: 記錄應付帳款
else Direct Credit<br>轉帳至 Cabital
    Cabital->>用戶: 增加帳戶餘額
    note right of 用戶: 記錄應收帳款
end
Cabital ->> 合作方: 轉帳請求成功
note over 用戶, 合作方: 清結算流程

loop 每日清算
Cabital->>Cabital: 匯總應付和應收帳款
Cabital->>合作方: 發送前日對帳明細
合作方->>Cabital: 確認對帳明細
end


loop T+N 結算
Alt 應收帳款 > 應付帳款
合作方->>Cabital: 鍊上轉帳至 Cabital 指定地址
Else 應收帳款 < 應付帳款
Cabital->>合作方: 鍊上轉帳至合作方指定地址
end
end

清結算周期

  1. 清算周期：每日日終進行清算，其中時間起訖為 00:00 ~ 23:59 (UTC)。
  2. 結算周期：在交易發生 N 天後進行結算 (T+N)，N 為 Cabital 與合作夥伴商定後決定。

收款地址

依不同幣種，建議合作夥伴提供以下網路的收款地址，當 Cabital 支付款項時會自行承擔 gas fee。

幣種 網路
BTC Bitcoin
ETH ERC20
USDC (Coming Soon) ERC20
USDT ERC20

對帳紀錄

Cabital 提供以下 3 種方式，讓合作夥伴可以查閱每一筆用戶的轉帳紀錄

API

可以透過以下 API 由合作方主動發起並查詢單筆或多筆轉帳紀錄

  1. 交易列表
    1. 以帳號 ID 查詢
    2. 以合作方帳號 ID 查詢
  2. 單筆交易
    1. 以轉帳交易 ID 查詢
    2. 以合作方轉帳交易 ID 查詢

訂閱報表

只需要提供收件人 email 信箱即可，系統將自動發送通知信給指定對象。

  1. 發送時間：每日 02:30 AM (UTC+0)
  2. 信件
    • 摘要：交易總數及總金額
    • 附件：前一日成功或失敗轉帳交易明細表
    • 文件：請參考下表
  3. 檔案格式：.xlsx

不適用對象

單日交易紀錄 20 萬筆以上的合作夥伴，由於附件檔案大小緣故，不適用此方案

SFTP

合作夥伴需要提供 Public key，並以指定 Username 及 Private key 登入以下 SFTP 路徑下載對帳文件。

準備工作

  1. 合作夥伴提供 Public key 給 Cabital

    範例

    ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDOZypQABxuCschD6jjRZFr1iPCqzrpo40Mzw6vXRfPlFwF9QJhLm3YYdtnpVekj9e1Y4kUduM924PAiLgfRw

  2. Cabital 進行配置，並提供 Username 用來登入 SFTP

  3. 合作夥伴訪問以下 SFTP 路徑 
    connect.sftp.cabital.com

  4. 合作夥伴使用 username 及 Private key 登入並至指定資料夾下載 csv 檔案格式的對帳文件

    文件目錄

    1. 交易明細：../Transactions/YYYY-MM-DD/
    2. 結算報表：../Settlement/YYYY-MM-DD/
    3. 清算明細：../Clearing/YYYY-MM-DD/

交易明細 Transactions

  1. 文件目的：用來查詢對帳前一日成功或失敗的雙方資金往來的歷程
  2. 欄位說明
    1. AMOUNT_ACTUAL：實際轉帳金額
    2. COUNTERPARTY_TRANSACATION_ID：發起轉帳或確認轉帳時，合作方給的 external_id
    3. CABITAL_TRANSACTION_ID：該筆交易用戶可在 Cabital 查詢的交易 ID
  3. 日切時間：00:00 (UTC+0)
  4. 文件生成時間：D+1 的 04:00 (UTC+0) 之前，通常會在 02:00 ~ 04:00 生成
  5. 特殊情境
    1. 當 Partner 有 Credit Line 要求時，一旦累積交易的待結算金額達 Credit Line 時，Cabital 會立即出款，而不是結算日期出款。
    2. 在這種情況下，當日出款的交易明細會體現在一份 Transaction 對帳文件中，當日剩餘的交易明細則會在另一份 Transaction 對帳文件裡。
報表範例
TRANSACTION_DATE TRANSACTION_TIME TRANSACTION_TYPE CABITAL_INSTRUCTION_ID CURRENCY AMOUNT_ACTUAL COUNTERPARTY COUNTERPARTY_TRANSACATION_ID STATUS CABITAL_TRANSACTION_ID
2022-08-08 12:00:00 Direct Debit 1121167c-bb3a-4a0f-8b7d-212a3ab7fc85 USDT 197.854465 Partner 1121167c-bb3a-4a0f-8b7d-212a3ab7fc85 Succeeded 87f69177-fad4-434b-93b9-9b9326aca2ca
2022-08-08 13:00:00 Direct Credit ea8e2f13-49dc-4403-8684-6e0892cb0c64 USDT 296.234565 Partner ea8e2f13-49dc-4403-8684-6e0892cb0c64 Succeeded a02a5f14-f511-4ca3-a808-ed2941dfe5ae
2022-08-08 14:00:00 Transfer Debit daa820e0-558d-4a04-80ef-b773460343f9 USDT 200.42327 Partner daa820e0-558d-4a04-80ef-b773460343f9 Succeeded 597eb77d-205d-4359-a0d1-2db008676d66
2022-08-08 15:00:00 Direct Debit 0408a791-701e-4e56-8915-20dbb4d83644 USDT 30.73 Partner 0408a791-701e-4e56-8915-20dbb4d83644 Succeeded c38d35e4-8f92-40af-94bb-37668c2d4a57
2022-08-08 16:00:00 Direct Credit ecd5b418-1206-41f0-847e-faacf8866539 USDT 0.00368846 Partner ecd5b418-1206-41f0-847e-faacf8866539 Succeeded c4385f6b-f7a4-4b35-883a-268b377196ec
2022-08-08 17:00:00 Transfer Debit 6e24591a-ca44-4d36-a7ea-1ab597af442a USDT 99.67 Partner 6e24591a-ca44-4d36-a7ea-1ab597af442a Failed e28dade8-ef14-4b66-a8e3-faf72117a793
2022-08-08 18:00:00 Direct Credit f2fa79a3-4dc5-424a-97a5-34349fb83266 USDT 498.25 Partner f2fa79a3-4dc5-424a-97a5-34349fb83266 Failed 9a0200cc-dd7d-440a-9751-1d3c84535d43
2022-08-08 19:00:00 Transfer Debit 1733f16e-df18-4cc6-826c-1dc1779f49d0 USDT 398.29 Partner 1733f16e-df18-4cc6-826c-1dc1779f49d0 Failed 13de1944-ae9e-4a9b-9a55-e7bfa179b4ac

結算報表 Settlement

預計 10 月中旬提供

  1. 文件目的：用來核對每一個幣種之已結算總金額
  2. 文件生成時間：結算日的次日
報表範例
CABITAL_SETTLEMENT_ID SETTLEMENT_DATE AMOUNT CURRENCY NETWORK TXN_HASH
00001 2022-08-15 725.2459885 USDT ETH 6e3d4646e1ad6d78bd225d2bdb5a14709c12e8280796a3b4f27536e8aaaf89ed
00002 2022-08-15 2 BTC BTC 8bf4782e925e3d93e68ca254e05dc30db518b953d38c9c2cc1eae8fdc571dfcc
00003 2022-08-15 25 ETH ETH c9c3a56b7176210be02a2c4a3751293722ca3eb02fb59e138988679ff3eabeec

清算明細 Clearing

預計 10 月中旬提供

  1. 文件目的：一筆結算資金，對應的具體交易明細
  2. 文件生成時間：結算日的次日
報表範例
TRANSACTION_DATE TRANSACTION_TIME TRANSACTION_TYPE CABITAL_INSTRUCTION_ID CURRENCY AMOUNT_ACTUAL COUNTERPARTY COUNTERPARTY_TRANSACATION_ID STATUS CLEARING_BATCH_ID CABITAL_SETTLEMENT_ID SETTLEMENT_DATE
2022-08-08 12:00:00 Direct Debit 1121167c-bb3a-4a0f-8b7d-212a3ab7fc85 USDT 197.854465 Partner 1121167c-bb3a-4a0f-8b7d-212a3ab7fc85 Succeeded 00001 100001 2022-08-15
2022-08-08 13:00:00 Direct Credit ea8e2f13-49dc-4403-8684-6e0892cb0c64 USDT 296.234565 Partner ea8e2f13-49dc-4403-8684-6e0892cb0c64 Succeeded 00001 100001 2022-08-15
2022-08-08 14:00:00 Transfer Debit daa820e0-558d-4a04-80ef-b773460343f9 USDT 200.42327 Partner daa820e0-558d-4a04-80ef-b773460343f9 Succeeded 00001 100001 2022-08-15
2022-08-08 15:00:00 Direct Debit 0408a791-701e-4e56-8915-20dbb4d83644 USDT 30.73 Partner 0408a791-701e-4e56-8915-20dbb4d83644 Succeeded 00001 100001 2022-08-15
2022-08-08 16:00:00 Direct Credit ecd5b418-1206-41f0-847e-faacf8866539 USDT 0.00368846 Partner ecd5b418-1206-41f0-847e-faacf8866539 Succeeded 00001 100001 2022-08-15