Virtual Client Accounts
Client External Incoming Transfers
A client incoming transfer of 100 GBP is received and there will be 5 GBP fee.
Funds flow on the service provider:
Balance changes with the timeline:
Timeline | Client Money Account - SP | Client Money Account - IF | Client Account - IF | Fee Collection Account - SP | Fee Collection Account - IF |
---|---|---|---|---|---|
T0 | 0 | 0 | 0 | 0 | 0 |
T1 | 100 | 0 | 0 | 0 | 0 |
T2 | 100 | 100 | 0 | 0 | 0 |
T3 | 100 | 100 | 95 | 0 | 0 |
T4 | 100 | 95 | 95 | 0 | 0 |
T5 | 95 | 95 | 95 | 5 | 0 |
T6 | 95 | 95 | 95 | 5 | 5 |
- T0: Client Money Account & Fee Collection Account are organization accounts. Client Account is an account belongs to a client. All accounts have 0 balance.
- T1: An incoming transfer of 100 is sent to a client IBAN / account number. Client Money Account on SP side is credited by 100.
- T2: IF Platform detects the incoming funds via webhook or polling. A provisioned account credit record is created and matched with a client IBAN / account number. Then, the incoming transfer record is created on Client Money Account by 100.
- T3: Fee is calculated as 5. Another incoming transfer record is created on the client account and got completed. Client account is credited by 100 and debited by 5. The account balance is 95. Client and organization transactions are linked together using relatedTransaction field. Organization transaction is called the actual transaction, client transaction is called the virtual transaction.
- T4: After the completion of the client incoming transfer, fee collection is handled instantly or using deferred collections. Either of these processes creates an internal outgoing transfer from Client Money Account to Fee Collection Account on IF side. Once this transfer gets to the processing state, Client Money Account is debited by 5 on IF side.
- T5: Outgoing transfer to collect the fees is released the service provider. Service provider debits Client Money Account by 5 and credits Fee Collection Account by 5 in its own records.
- T6: IF Platform detects the internal incoming transfer to Fee Collection Account and credits the account by 5 on its own records.
Client External Outgoing Transfers
A client outgoing transfer of 50 GBP is created and there will be 10 GBP fee.
Funds flow on the service provider:
Balance changes with the timeline:
Timeline | Client Money Account - SP | Client Money Account - IF | Client Account - IF | Fee Collection Account - SP | Fee Collection Account - IF |
---|---|---|---|---|---|
T0 | 95 | 95 | 95 | 5 | 5 |
T1 | 95 | 95 | 35 | 5 | 5 |
T2 | 95 | 45 | 35 | 5 | 5 |
T3 | 45 | 45 | 35 | 5 | 5 |
T4 | 45 | 35 | 35 | 5 | 5 |
T5 | 35 | 35 | 35 | 15 | 5 |
T6 | 35 | 35 | 35 | 15 | 15 |
- T1: Client account balance on IF side is debited by 60 while transitioning from pending to processing.
- T2: After client transaction is updated as processing, the actual transaction of this client transfer needs to be created. The actual transaction is created and it debits the Client Money Account on IF side by 50. Fee amount will be debited when fee collection happens later.
- T3: Both organization and client transfer records are reflected to the service provider as a single transfer. Service provider debits the Client Money Account by 50 and transfer is updated as completed.
- T4: After the completion of the client outgoing transfer, fee collection is handled instantly or using deferred collections. Either of these processes creates an internal outgoing transfer from Client Money Account to Fee Collection Account on IF side. Once this transfer gets to the processing state, Client Money Account is debited by 10 on IF side.
- T5: Outgoing transfer to collect the fees is released the service provider. Service provider debits Client Money Account by 10 and credits Fee Collection Account by 10 in its own records.
- T6: IF Platform detects the internal incoming transfer to Fee Collection Account and credits the account by 10 on its own records.
Client Exchange Transactions
A client exchange transaction to sell 100 EUR to buy GBP is created.
Service Provider offers 83 GBP for 100 EUR. Service provider rate: 0,83
IF Platform adds markup and transparent fee to the service provider offer.
IF Platform offers 80 GBP for 100 EUR to the end user. Client rate: 0,81. So, 2 GBP will be markup profit and 1 GBP will be transparent fee.
Funds flow on the service provider:
Balance changes with the timeline:
Timeline | Client Money Account - EUR - SP | Client Money Account - EUR - IF | Client Account - EUR - IF | Client Money Account - GBP - SP | Client Money Account - GBP - IF | Client Account - GBP - IF | Fee Collection Account - GBP - SP | Fee Collection Account - GBP - IF |
---|---|---|---|---|---|---|---|---|
T0 | 100 | 100 | 100 | 35 | 35 | 35 | 15 | 15 |
T1 | 100 | 100 | 0 | 35 | 35 | 35 | 15 | 15 |
T2 | 100 | 0 | 0 | 35 | 35 | 35 | 15 | 15 |
T3 | 0 | 0 | 0 | 118 | 35 | 35 | 15 | 15 |
T4 | 0 | 0 | 0 | 118 | 118 | 115 | 15 | 15 |
T5 | 0 | 0 | 0 | 118 | 115 | 115 | 15 | 15 |
T6 | 0 | 0 | 0 | 115 | 115 | 115 | 18 | 15 |
T7 | 0 | 0 | 0 | 115 | 115 | 115 | 18 | 18 |
- T1: Client account balance on IF side is debited by 100 EUR on exchange transaction creation.
- T2: Before booking the exchange on the service provider, we need to be sure that the Client Money Account has sufficient balance. Therefore, an organization transaction is created on the Client Money Account of buy & sell currencies as the actual transaction of the client transaction. This transaction has the amounts as offered by the service provider. Once its created, the Client Money Account in EUR on IF side is debited by 100 EUR.
- T3: After both client and organization transactions are created, they are booked at the service provider as a single transaction. The service provider debits the sell side by 100 EUR and credits the buy side by 83 GBP on transaction completion.
- T4: Once IF Platform receives the updates from the service provider, transaction is marked as completed and accounts on the buy side are credited. The Client Money Account is credited by 83 GBP while the client account is credited by 80 GBP because of markup & fee.
- T5: After the completion of the client exchange transaction, fee collection is handled instantly or using deferred collections. Either of these processes creates an internal outgoing transfer from Client Money Account to Fee Collection Account on IF side. Once this transfer gets to the processing state, Client Money Account is debited by 3 on IF side.
- T6: Outgoing transfer to collect the fees is released the service provider. Service provider debits Client Money Account by 3 and credits Fee Collection Account by 3 in its own records.
- T7: IF Platform detects the internal incoming transfer to Fee Collection Account and credits the account by 3 on its own records.
Updated 19 days ago