The Cards section explains to the user how to manage card information associated with their accounts. Users can add, update, and remove cards, as well as retrieve details such as card number and expiration date. This section provides essential functionality for handling payment methods within the application. > **Note:** Deposits made to cards must be at least 10 USD to be processed.

This section comprises all the API endpoints to interact with Virtual Wallet, which is the entry point for the user to make deposits on any available blockchain.

A Holding Wallet is a wallet that is created when the user requests to create their first virtual wallet for a given blockchain. This wallet will be used to centralize all deposits made to all virtual wallets on such blockchain. Whenever a deposit is done on a Virtual Wallet, the tokens get transferred to the Holding Wallet almost immediately.

This module allows users to get a Holding Wallet balance, information (Alias, address and id) and to withdraw tokens from it.

Configuration is a group of endpoints that allows users to manage and query system settings.

This module offers customers the possibility to generate Virtual Wallets on various blockchain networks to send, receive and record balances and movements. It simplifies the management of digital assets and allows to establish automated rules for user flows. All the assets will be stored on a Holding Wallet that will be created when the first Virtual Wallet is created. There is only one Holding Wallet for each blockchain. When a deposit is made to one of the addresses it will accredit it instantly. These Virtual Wallets will have a virtual balance, which represents the amount of tokens that belongs to those addresses. > **Note:** Deposits made to virtual wallets must be at least 1 USD to be processed.

Virtual Wallets:

Virtual wallets are interfaces that allow users to interact with the blockchain in a more accessible and user-friendly way without the need to directly manage the private keys associated with their digital assets. This reduces the technical complexity and risks associated with the loss or mismanagement of these keys, making blockchain technology more accessible to the average user.

Virtual Wallets also have the capability to be deactivated, ensuring that they do not occupy space within the pool of available virtual wallets. This feature allows for better management and allocation of resources, ensuring that only active and necessary wallets consume system resources.

Holding Wallet:

At the core of the Virtual Wallet infrastructure is the Holding Wallet. This is a unique wallet designated for each blockchain, where all users’ digital assets are stored. The Holding Wallet is responsible for managing the actual funds and executing transactions on behalf of the Virtual Wallets. This centralized approach allows for greater security and efficiency in the management of digital assets.

Virtual Balance:

Virtual Wallets display to users a virtual balance that reflects the amount of tokens allocated to their specific addresses. However, these real assets are centrally stored in the Holding Wallet. This virtual representation allows for more agile and secure management, eliminating the need for users to interact directly with the blockchain for each operation.

Instant Transactions:

One of the key benefits of Virtual Wallets is the ability to perform instant transactions from the user’s perspective. When a deposit is made to a Virtual Wallet address, the balance is updated immediately in the user interface, providing a seamless and delay-free experience. Meanwhile, the underlying transaction on the blockchain is processed in the background and may take a bit longer to confirm, depending on network congestion and conditions.

User Flow Automation:

Virtual Wallets also offer advanced automation capabilities, allowing users to set customized rules for managing user flows. This can include setting up automatic transfers, alerts, and notifications, among other features that significantly enhance the user experience. Automation reduces the need for manual intervention, making digital asset management more efficient and secure.

Financial Management:

The Holding Wallet plays a critical role in financial management. It allows for partial withdrawal of the balance, keeping a reserve ratio against the Virtual Wallets, which facilitates the handling of user funds to generate additional benefits. It is essential to maintain a guarantee fund within the Holding Wallet to ensure that customer withdrawals are always covered. Failing to do so would result in insufficient funds errors when attempting withdrawals.

Moreover, if assets are transferred from the Holding Wallet to a Virtual Wallet, the balance of the latter will be updated even if the Holding Wallet does not have sufficient funds to cover that amount. This mechanism can create leverage by effectively using capital beyond the immediate balance of the Holding Wallet.

This section comprises all the API endpoints to interact with Virtual Wallet, which is the entry point for the user to make deposits on any available blockchain.

Creates a new virtual wallet with an alias, for a specific blockchain.

Required access level: Operational Access (Level 2)

Retrieves all existing virtual wallets for a given blockchain.

Required access level: Read-Only Access (Level 1)

Retrieves all the information of a virtual wallet by it's ID.

Required access level: Read-Only Access (Level 1)

Updates the virtual wallet's alias.

Required access level: Operational Access (Level 2)

Deletes a virtual wallet by ID. If the wallet has some virtual balance it can't be deleted.

Required access level: Operational Access (Level 2)

Retrieves the balance from a specific Virtual Wallet by it's id.

Required access level: Read-Only Access (Level 1)

This initiates a request to transfer tokens from one of the Virtual Wallets to an external wallet, facilitated by the Holding Wallet. When viewing the transaction in the explorer, it will display the transaction as originating from the Holding Wallet address.

The Holding Wallet must contain a sufficient balance to complete the transaction, otherwise, an exception will occur, and the transaction will not get executed.

Required access level: Operational Access (Level 2)

Enable or disable a virtual wallet. If a virtual wallet is disabled then deposits won't be detected automatically. Disable virtual wallets to reduce maintenance costs.

Required access level: Operational Access (Level 2)

Retrieve the most recent movements associated with a specified wallet, allowing users to track and monitor the financial activity within the selected account. By adjusting the optional parameter "size," users can customize the number of movements returned for more precise analysis. This feature requires Operational Access (Level 2) authorization for secure access to movement data.

Obtain the last 4 movement made by the selected wallet. It is possible to change the number of item obtained using the parameter “size”

Additionally, using the parameter “paging_state_token” you can retreive more options, only if the previous answer has a value in the respose “paging_state_token”.

Required access level: Operational Access (Level 2)

Associates a company client with an Active Management virtual wallet, enabling the client to perform ramp operations using that wallet.

Required access level: Operational Access (Level 3)

A Holding Wallet is a wallet that is created when the user requests to create their first virtual wallet for a given blockchain. This wallet will be used to centralize all deposits made to all virtual wallets on such blockchain. Whenever a deposit is done on a Virtual Wallet, the tokens get transferred to the Holding Wallet almost immediately.

This module allows users to get a Holding Wallet balance, information (Alias, address and id) and to withdraw tokens from it.

Configuration is a group of endpoints that allows users to manage and query system settings.

The treasury module offers you a seamless way to integrate the functionalities of a decentralized wallet, along with the capability to send and receive your crypto assets. This module covers everything from setting up a single wallet to managing multiple ones, all without delving into the complexities of web3.0 terminology. This ensures a smoother integration and user experience overall. > **Note:** Deposits made to treasury wallets must be at least 1 USD to be processed.

The Management API is your all-in-one powerhouse for steering the ship of account management. It functions as a sophisticated toolkit, empowering users to seamlessly create, tweak, or bid farewell to clients, accounts, users, and access levels. Acting as a refined interface, it grants users granular control over the organizational account landscape, facilitating tasks such as spinning up new clients or tweaking existing configurations on the fly. Need to sculpt user accounts to fit the evolving needs of your operation? You got it. It doesn’t stop there – the API lets you fine-tune access levels, ensuring a secure and compliant environment. And when it’s time for some digital spring cleaning, the API’s deletion functionalities let you tidy up by retiring entities that have overstayed their welcome. It’s like having a backstage pass to the techy side of account management without the fuss.

For using this API you need to use your API key that have MANAGEMENT permission.

The Management API is your all-in-one powerhouse for steering the ship of account management. It functions as a sophisticated toolkit, empowering users to seamlessly create, tweak, or bid farewell to clients, accounts, users, and access levels. Acting as a refined interface, it grants users granular control over the organizational account landscape, facilitating tasks such as spinning up new clients or tweaking existing configurations on the fly. Need to sculpt user accounts to fit the evolving needs of your operation? You got it. It doesn’t stop there – the API lets you fine-tune access levels, ensuring a secure and compliant environment. And when it’s time for some digital spring cleaning, the API’s deletion functionalities let you tidy up by retiring entities that have overstayed their welcome. It’s like having a backstage pass to the techy side of account management without the fuss.

For using this API you need to use your API key that have MANAGEMENT permission.

The Simulate section allows users to test and replicate transaction events within the API Layer using the account’s configured mechanisms. By simulating transactions, users can ensure that the API functions correctly and accurately reflects real-world scenarios. This section is essential for developers to validate the behavior of their applications and ensure seamless integration with the API Layer.

Webhooks provide real-time notifications for API events, enabling your platform to receive timely updates about specific activities. Our system sends these notifications to a designated endpoint within your hosted environment, which is configured to adeptly receive and process them.

Leverage webhooks to promptly obtain information about critical API events. These events include occurrences external to your system, such as a new deposit in an MPC wallet or a card transaction at a point-of-sale (POS) terminal.To seamlessly receive and process webhook-enabled events, you need to establish and configure a webhook endpoint within your environment.

Each webhook request consists of a common part and a custom payload specific to the event being communicated. The common part includes standard information such as the event type, sub-type, status and a unique Id of of the notification, while the custom payload contains detailed data relevant to the specific event.

General payload example:

{
"operation": "TREASURY",
"sub_operation": "DEPOSIT",
"operation_id": "ca0c57d2-b1c9-4bcd-9d5d-8d361cad6fddds1c",
"status": "FINISHED",
"data": { }
}