Overview

The V2V (Virtual Account to Virtual Account) API allows clients of Decentro to transfer funds between their virtual accounts. This API facilitate seamless fund transfers while ensuring compliance with the specified business rules.

🙌

Important note

Please use only Staging Credentials on each API Reference page to test the APIs directly from our Documentation.

Flow

Below is the flow for using the virtual transfer flow through Decentro.

1. The client completes the onboarding process on the Decentro E-Collect stack.
2. The client creates multiple virtual accounts based on their specific requirements using create virtual account API
3. The client prepares to move funds using the V2V API by sending a request to the transfer endpoint.
4. Decentro will processes the virtual fund transfer between virtual accounts and responds to the client.
5. Decentro will send an account balance callback to the client's pre-configured URL once the virtual transfer is completed.

API Endpoints

Below are the API endpoints to be used by the platform basis the environments.

Points to highlight

The virtual transfer between any two virtual accounts must follow below business rules:

• Both virtual accounts must belong to Decentro.
• The source account must have enough funds to cover both the requested transfer amount and any applicable commission fees.
• Transfers are not allowed between virtual accounts belonging to different underlying accounts.
• Funds can be transferred between VAs of different consumers only if there is a parent-child relationship between them.