Skip to content

Settlement

Partner can initiate transfer from customer's Cabital wallet to the partner's platform via API (Direct Debit), or the customer can transfer on the Cabital widget by their own (Transfer Debit). Regardless of the type of transfer, we will advance the funds to the customer's wallet first to provide instant user experience.

Cabital clears the accounts at the end of each day and partners can check the reconciliation documents in different ways and settle the accounts payable or receivable at the agreed time, and then settle the payments to the agreed collection address.

3 Types of Transfers

  1. Direct debit: Initiated by partners, the funds will be transferred from the customer's Cabital account to the partner account, it can be applied to deposits, purchases, etc.
  2. Direct credit: Initiated by partners, the funds will be transferred from the customer's partner account to the Cabital account, it can be applied to withdrawals, refunds, bonus payments, etc.
  3. Transfer debit: Initiated by customer on the Cabital platform, the funds will be transferred from the customer's Cabital account to the partner account, and the balance of the customer's Cabital account will be deducted only after the partner has confirmed this transfer.

Flow Chart

 sequenceDiagram 
participant Customer
participant Cabital 
participant Partner

note over Customer, Partner: Transfer Process
Customer ->> Partner: Transfer Fund
Partner ->> Cabital: Transfer Request
alt Direct Debit<br>Transfer to Partner
    Cabital->>Customer: Deduct Account Balance
    note right of Customer: Record Accounts Payable
else Direct Credit<br>Transfer to Cabital
    Cabital->>Customer: Credit Account Balance
    note right of Customer: Record Account Receivable
end
Cabital ->> Partner: Transfer Request Successful
note over Customer, Partner: Clearing and Settlement Process

loop Daily Clearing
Cabital->>Cabital: Aggregate Accounts Payable and Accounts Receivable
Cabital->>Partner: Send The Reconciliation Report of Previous Day
Partner->>Cabital: Confirm The Reconciliation Details
end


loop T+N Settlement
Alt Account Receivable > Account Payable
Partner->>Cabital: Payment to The Cabital's Address
Else Account Receivable < Account Payable
Cabital->>Partner: Payment to The Partner's Address
end
end

Clearing And Settlement Cycle

  1. Clearing cycle: Clearing at the end of each day, and the time starts from 00:00 to 23:59 (UTC).
  2. Settlement cycle: Settlement after the Nth day of the transaction, as determined by Cabital in agreement with the partner.

Payment Address

Depending on the currency, it is recommended that partners provide the following network's payment address and Cabital will cover the gas fee of each payment.

Currency Network
BTC Bitcoin
ETH ERC20
USDC (Coming Soon) ERC20
USDT ERC20

Reconciliation Report

Cabital offers 3 ways for partners to inquiry the transfer history of each transaction.

API

Partner can query single or multiple transfer records through the following APIs:

  1. List of transfer transactions
    1. List all transfers by account ID
    2. List all transfers by partner's account ID
  2. Retrieve a transfer record
    1. Retrieve a transfer by transfer ID
    2. Retrieve a transfer by partner's transaction ID

Subscribe to Reports

Partner can provide the recipient's email address and we will automatically send reports to them.

  1. Sending time: 02:30 AM (UTC+0)
  2. Email format
    • Summary: Total number of transactions and total amount of each currency.
    • Attachment: Successful or failed transfer transaction details of previous day.
    • Report: Please refer to the following table.
  3. File format: .xlsx

Not applicable scenario

For partners with more than 200,000 transactions in a single day, this solution is not suitable due to the file size limitation of the attachment.

SFTP

The partner needs to provide Public key and login to the SFTP with Username and Private key to download the reconciliation files.

Preparation

  1. Partner provide Public key to Cabital

    Example

    ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDOZypQABxuCschD6jjRZFr1iPCqzrpo40Mzw6vXRfPlFwF9QJhLm3YYdtnpVekj9e1Y4kUduM924PAiLgfRw

  2. Cabital set up the configuration and provide Username to the partner to login SFTP

  3. Partner access the following SFTP path 
    connect.sftp.cabital.com

  4. Partner login SFTP with the Username and Private key and download the csv file format of reconciliation report

    Files folder

    1. Transactions report: ../Transactions/YYYY-MM-DD/
    2. Settlement report: ../Settlement/YYYY-MM-DD/
    3. Clearing report: ../Clearing/YYYY-MM-DD/

Transactions Report

  1. Purpose: It is used to check the history of fund transactions between both sides that were successful or failed of previous day.
  2. Field description:
    1. AMOUNT_ACTUAL: Actual amount transferred
    2. COUNTERPARTY_TRANSACATION_ID: The external_id given by the partner when initiating a transfer or confirming a transfer
    3. CABITAL_TRANSACTION_ID: The transaction user can check the transaction ID at Cabital
  3. Day cut time: 00:00 (UTC+0)
  4. Files generation time: Before 04:00 (UTC+0) of D+1, it is usually generated at 02:00 ~ 04:00
  5. Special cases:
    1. When Partner has a Credit Line request, Cabital will issue funds as soon as the pending settlement amount of the accumulated transactions reaches the Credit Line, instead of the settlement date.
    2. In this case, the transaction details of the current day's payment will be reflected in one transaction report and the remaining transaction details of that day will be in another transaction report.
Sample
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 Report

Expected to be available in mid-October

  1. Purpose: It is used to check the total amount settled for each currency
  2. Files generation time: The next day of settlement
Sample
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 Report

Expected to be available in mid-October

  1. Purpose: It is used to check the details for each settlement record
  2. Files generation time: The next day of settlement
Sample
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