Assets
In Midaz, an Asset represents the item being transferred in a transaction.
As a multi-asset and multi-currency system, Midaz offers unparalleled flexibility, allowing you to define assets that suit your operational needs—whether they are digital, physical, or even unconventional forms of value.
Assets in Midaz empower organizations to transact with clarity, precision, and adaptability.
What is an Asset?
An Asset in Midaz can be anything of value that is used in transactions, such as:
- Currencies: Traditional fiat currencies like BRL (Brazilian Real) or EUR (Euro), and cryptocurrencies like BTC (Bitcoin).
- Physical Commodities: Items like soybeans, cattle, or even refrigerators.
- Custom Items: Non-traditional forms of value, such as loyalty points, medicines, or any other tokenized item.
This flexibility ensures that Midaz can accommodate diverse business models, industries, and use cases.
Benefits of Assets in Midaz
- Versatility: Define and manage diverse asset types to align with your unique business needs.
- Precision: Customize configurations such as decimal places to match the characteristics of each asset.
- Scalability: Add new assets as your organization’s operations expand or evolve.
- Control: Activate or deactivate assets as needed, ensuring compliance and operational efficiency.
Key Characteristics of Assets
- Identification: Each Asset is uniquely identified by a code, such as BRL or BTC, which must be specified in every transaction.
- Active Status: To be used in a transaction, an Asset must be active on the platform. Attempting to transact with an inactive Asset will result in an error.
- Individual Configuration: Assets are created individually within a Ledger, enabling unique configurations such as the number of decimal places.
Example
Imagine a Ledger needs to handle Bitcoin (BTC) and Brazilian Real (BRL):
- BTC can be configured with up to 8 decimal places.
- BRL can be configured with 2 decimal places, reflecting traditional currency standards.
Managing Assets
To manage your Assets you can use the Assets API or the Assets tab of the Ledgers page on Midaz Console.
View Assets Details
- Via API:
- To view the details of all Assets, use the List Assets endpoint.
- To view the details of a specific Asset, use the Retrieve an Asset endpoint.
- Via Console: Access the Assets tab to view the detais of an Asset. For more information, refer to the Managing Assets page.
Create an Asset
- Via API: Use the Create an Asset endpoint.
- Via Console: Create an Asset from the Assets tab of the Ledgers page. For more information, refer to the Creating the First Asset or the Creating a new Asset pages.
Edit an Asset
- Via API: Use the Update an Asset endpoint.
- Via Console: Edit Asset details from the Assets tab of the Ledgers page. For more information, refer to the Editing Asset Information page.
Delete an Asset
- Via API: Use the Delete an Asset endpoint.
- Via Console: Delete an Asset from the Assets tab of the Ledgers page. For more information, refer to the Deleting an Asset page.
Important
An Asset can only be deleted if no balance is available in its Ledger accounts. Therefore, all remaining amounts must be moved to an External Account before deleting the Asset.
Updated 8 days ago