On Ledger
Overview
The CLOWD9 On Ledger solution enables your Customers to spend against their available balance as per the agreed Terms and Conditions.
CLOWD9’s On Ledger solution handles various use cases/asset classes:
- *Single Currency Account associated one or multiple Customer and Cards
- *Multi Currency Accounts associated one or multiple Customer and Cards
- Crypto Backed Accounts
- Commodity Backed Accounts
*The type of Account(s) created will be based on Product and Account configuration. For example, Multi Currency Accounts will not be created for a Product which is configured for a Single Currency Account offering.
The balances held by CLOWD9 will be adjusted according to the financial activity as follows:
- Credit Account Balance: Following a successful request, the balance will be increased by the value provided
- Debit Account Balance: Following a successful request, the balance will be decreased by the value provided
- Authorizations: Following an approved authorization, the value authorized will be reserved against the balance preventing the Customer spending more than they have. For example, the Customer has a 100.00 balance and spends 40.00. The available balance will decrease by 40.00 with the Debit Reservation increasing by 40.00. As a result the Customer will be permitted to spend a maximum of 60.00
- Clearing: The Network will provide CLOWD9 with the clearing record for processing. CLOWD9 will match the clearing to the original authorization whereby the Debit Reservation will decrease and the actual balance will decrease by the final value. There may be instances where CLOWD9 are unable to match which could result in the value being "double" debited until either:
- The amount is manually removed, or
- The original authorization period has exceeded and the amount is removed
- Refunds / Balance Increases (via the Network): The Account balance will increase by the value received
- Reversals: The previous value will be reversed with the Account balance changing as per the Reversal value (Full Vs Partial)
The physical funds movements will take place outside of the CLOWD9 platform and therefore CLOWD9 can only hold the “values” of individual customer funds within its platform as instructed by you via our APIs and / or the Network financial messages.
Account Management
Our Account Management APIs provide you with the services needed to manage your Customers Accounts:
- Create Account: Following a succesful requests, you will be provided with either a single account_id or multiple account_id, depending on your product configuration

- Credit Account Balance: Increases the balance by the value provided (funded by the Customer)
- Decrease Account Balance: Decreases the balance by the value provided. Normally used when a Customer is closing their Account and withdrawing all funds
- Account Status: Allows you to amend the status of an Account. Note, some of the status values are permanent and cannot be reversed
- Retrieve Account Information for a Customer: Provides you with the The Retrieve Account Information provides you with the details for a specific account_id for a specific Customer. This API does not return any ledger entries
- Retrieve Customer Account Ledger Entries: Allows you to retrieve the Ledger Entries for a specific customer_id & account_id. Specific dates from and to can be specified where required
- Retrieve Account Information: The Retrieve Account Information API enables you to retrieve the information held for a specific account_id
- Retrieve Ledger Entries for a Customer: Provides you with the all account activity for a specific customer_id. By entering from and to dates, only activity that took place within the specified period will be providedTo be discussed if needed as should be by account_id?
- Retrieve Ledger Entries for an Account: Retrieve all entries for a specific account_id. Specific dates from and to can be specified where required
Updated 18 days ago