Add Currency

Overview #

The “Add Currency” feature allows you to add new currencies to your platform. This feature is essential for enabling transactions in different currencies on your website or application. Before adding a currency, ensure that you have already added a payment gateway (Manual or API) that supports the desired currency.

Navigation #

1. Access the Currency Section:
   • Before adding a currency, ensure you have added a payment gateway (Manual or API).
   • Navigate to the Currency section from the sidebar menu.
2. Add Currency:
   • Once in the Currency section, locate the option to add a new currency.
   • Click on the Add Currency button to proceed to the currency creation form.

Form Fields #

Fill in the following fields to add a new currency:

1. Currency Title
   • Description: The name or title of the currency (e.g., US Dollar, Bitcoin).
   • Requirements: Required, maximum 150 characters.
2. Currency Code
   • Description: The official 3-letter currency code (e.g., USD, BTC, EUR).
   • Requirements: Required, must be unique, in uppercase.
3. Network Code
   • Description: The blockchain or network(s) used for the currency (e.g., TRON, BTC, ARBITRUM). If multiple networks are supported, separate them with commas, no spaces.
   • Requirements: Optional, must be in uppercase letters.
4. Gateway Type
   • Description: Select whether the transaction gateway is Manual (processed by admin) or API (automated processing).
   • Requirements: Required, must be either ‘Manual’ or ‘API’.
5. Gateway
   • Description: Select the specific gateway integration used for processing this currency.
   • Requirements: Required, must select one from the configured list.
6. Reserve Amount
   • Description: The system reserve available for this currency, used to determine exchange capacity.
   • Requirements: Optional, must be a numeric value.
7. Exchange Fee
   • Description: The fee charged for exchanging this currency.
   • Requirements: Optional, numeric value.
8. Exchange Fee Type
   • Description: Specify whether the exchange fee is Fixed (e.g., $5) or Percentage (e.g., 2%).
   • Requirements: Optional, must select either ‘Fixed’ or ‘Percentage’.
9. Payout Fee
   • Description: The fee applied when paying out in this currency.
   • Requirements: Optional, numeric value.
10. Payout Fee Type
    • Description: Select whether the payout fee is applied as a Fixed value or a Percentage of the transaction.
    • Requirements: Optional, must choose one.
11. Min Reserve Alert
    • Description: Threshold to trigger a low reserve warning for this currency.
    • Requirements: Optional, numeric value.
12. Cryptocurrency?
    • Description: Indicate whether this currency is a cryptocurrency.
    • Requirements: Required, select ‘Yes’ or ‘No’.
13. Cryptocurrency Confirmation
    • Description: The number of blockchain confirmations required to validate a payment.
    • Requirements: Required only if the currency is a cryptocurrency. Must be a numeric value (e.g., 3 or 6).
14. Decimal Precision
    • Description: The number of digits allowed after the decimal point (e.g., 2 for USD, 8 for BTC). Use Default for system-wide setting.
    • Requirements: Optional, integer or select ‘Default’.
15. Currency Group: Categorize the currency for frontend display grouping. Options include:
    • Fiat
    • Stable
    • Crypto
    • Bank
    • Card
    • Default (shows currency code only, e.g., USD, EUR)
    • Requirements: Required, select from the dropdown.
16. Sort Order
    • Description: Set the display order of the currency on the frontend. Lower numbers are shown first.
    • Requirements: Optional, integer value (e.g., 1, 2, 3).
17. Allow Send Payments
    • Description: Determines whether users can send this currency.
    • Requirements: Required, select ‘Yes’ or ‘No’.
18. Allow Receive Payments
    • Description: Determines whether users can receive this currency.
    • Requirements: Required, select ‘Yes’ or ‘No’.
19. Default Send Method
    • Description: Set this currency as the default send method for transactions. Only one currency should be marked as default.
    • Requirements: Optional, select ‘Yes’ or ‘No’. Required to be ‘Yes’ if no other default send currency exists.
20. Status
    • Description: The current operational status of the currency.
    • Options: Active – currency is live; Inactive – currency is disabled.
    • Requirements: Required.
21. Logo
    • Description: Upload a logo/icon for the currency. A PNG file with a transparent background is recommended.
    • Requirements: Required. Must be one of the following formats: jpeg, png, jpg, svg. The maximum file size must comply with the settings

Usage Instructions #

1. Navigate to Currency Section:
   • Go to the Currency section from the sidebar menu.
2. Add Currency:
   • Click on the Add Currency button.
3. Fill in the Form Fields:
   • Enter the required information into the respective fields.
4. Save Currency:
   • After filling in the necessary fields, click on the Save button to add the currency.

Conclusion #

Adding a currency enables your platform to support transactions in multiple currencies, expanding your user base and enhancing user experience. Ensure accurate configuration of currency details to facilitate seamless transactions on your platform.