Hub currencies configuration

[ei-nghon-phoo]

User Story:

As a scheme owner, I want to configure currencies from user interface so that we can have seamless scheme that operate in desirable currencies.

Acceptance Criteria:

Acceptance Criteria for Currency Configuration:

1. Global Currency Standard: • The system will utilize the ISO 4217 standard for global currencies. • Currency configuration will include the following attributes: decimal place, numeric code, alphabetic code, and currency description. • ISO currency formats

2. Addition of New Currencies: • If a hub operator wishes to update the currency list with a currency not included in the latest system currency list, or update the existing currency's attributes, they should be able to do so via the API.

3. Currency Onboarding for Hub Operators: • Default currencies configured at the hub should automatically create corresponding accounts. • The hub operators have the option to manually create accounts for currencies beyond the default selection. • If hub operators choose to add accounts for currencies beyond the defaults, they can do so through manual creation.

4. Participant DFSP Currency Creation: • Participant DFSPs will have the capability to create accounts with newly onboarded currencies.

5. Currency Display in Admin Portal UI: • Currency-related drop-down menus and displays in the admin portal UI should reflect the updated currency list, ensuring alignment with the system's currency configuration.

6. Adding a currency should adhere maker checker mechanism.

7. The system should enable the hub operators to add multiple currencies within a single hub. (Background: Some hubs will facilitate cross-border payments, necessitating multi-currency payment operations.)

approach to be considered

• enabling hub operators to configure currency from the user interface with or without maker checker mechanism
• configuring hub currencies from hub onboarding/set up stage from backend or infrastructure level.

[ei-nghon-phoo]

Future plan: disabling a currency.

[ei-nghon-phoo]

Action plan

• [x] Adding MongoConfigSetRepo and ‌adding new currency from API with the attributes (numeric code, currency code and decimal place) with ISO 4217 format.
• [ ] Consuming config changes from other Bounded Contexts
• [ ] Updating Admin UI to use the platform-configurations-bc: design file

cc: @hsuyeemon-tw

[bushjames]

@PaulMakinMojaloop Please can you review this ticket and let us know your opinion on if maker checker is needed for maintaining the list of ISO4217 currencies in the hub? Please can we have an agenda item on the product council call to discuss perhaps?

[elnyry-sam-k]

Discussed this on a call with the team on 7th March; @TW-Ei-Nghon-Phoo volunteered to post a summary of the discussion regarding this issue

[elnyry-sam-k]

@TW-Ei-Nghon-Phoo can you please post a summary of our discussion and consensus on this - that currencies will be configured part of the deployment (using ISO 4217) list and enabling or disabling essentially is done at account level.