Currencies & Exchange Rates

**Menu:** Platform Admin → Financial → Currencies

Define all currencies available across the ecosystem.

Prerequisites

1. Financial / wallet admin permission.
2. Agreement on base currency and naming conventions.

Page layout

• Table: code, name, symbol, decimals, Active, sort order.
• New currency form: ISO-style code, display names, icon optional.
• Flags: cashable, transferable, visible in portal.

Step-by-step

1. Open Financial → Currencies.
2. Review existing list before adding duplicates.
3. New currency — enter code (e.g. USD, EUR, GOLD).
4. Set decimal precision (0 for points, 2 for fiat).
5. Enable Active when ready for rate rows.
6. Disable instead of delete if history exists.

Tips

• Inactive currency hides new operations but keeps ledger history.
• Align codes with broker panel if broker module shares currencies.

**Menu:** Platform Admin → Financial → Exchange rates

Maintain conversion matrix between active currencies.

Page layout

• Grid or list: from currency, to currency, rate, buy rate, sell rate, effective time.
• Add rate / bulk import (if enabled).
• History or audit of last change (configuration-dependent).

Step-by-step

1. Open Exchange rates.
2. Select from and to pair.
3. Enter mid rate or separate buy and sell if spread model used.
4. Set effective from datetime if scheduled change needed.
5. Save and verify in club panel preview if exposed downstream.
6. Document change in internal finance log.

Tips and common issues

• Missing reverse pair may block convert both ways — add both directions or auto-inverse policy.
• Large sudden changes may trigger member support tickets — plan communication.
• Zero or negative rates are rejected — validate before save.

**Menu:** Club Panel → Financial → Exchange rates

Club-level view and override of rates shown to members (when club customization is allowed).

Prerequisites

1. Wallet and multi-currency options active.
2. Platform base currencies already defined.
3. Permission to view or edit club financial settings.

Page layout

• List of currency pairs enabled for the club.
• Columns: pair, platform rate, club override (if any), spread %, last updated.
• Toggle: use platform default vs custom club rate.
• Preview calculator: amount in → amount out (sanity check).

Step-by-step

1. Open Financial → Exchange rates.
2. Identify pairs members use most (e.g. IRR ↔ USD points).
3. For each pair, choose platform default or enter club override.
4. Adjust spread per commercial policy.
5. Run preview with sample amounts.
6. Save; ask test member to refresh wallet before go-live announcement.
7. Review weekly or when central bank / broker feed moves significantly.

Tips

• Club override typically cannot invent new currency codes — only tune rates for enabled pairs.
• Coordinate with Currency broker module if broker supplies liquidity.
• Display rounding matches currency decimal settings.

**Menu:** User Portal → Wallet → Exchange (or Convert)

Members exchange balances between wallets/currencies permitted by the club.

Prerequisites

1. Member signed in with sufficient source balance.
2. Target currency wallet exists or auto-created per club rules.
3. Exchange feature enabled on club subscription.

Page layout

• From currency selector and balance display.
• To currency selector.
• Amount input; live estimated receive using current rate.
• Fee line if applicable.
• Confirm screen with rate snapshot and timestamp.

Step-by-step

1. Open Wallet → Exchange / Convert.
2. Choose from and to currencies.
3. Enter amount (or max).
4. Read rate, fee, and final credit.
5. Confirm with OTP or PIN if required.
6. View receipt in Transactions.

Tips and common issues

1. Platform admin maintains currency master list.
2. Platform sets baseline exchange table.
3. Club optionally overrides spread for commercial goals.
4. Finance monitors broker or manual feed weekly.
5. Support uses transaction receipt rate field for disputes.

• Currencies = master data; exchange rates = conversion math; club may add spread.
• Members exchange only from Wallet — no panel path needed for them.
• Disputes: compare receipt timestamp to rate effective time.