v1.0.0 Stable

Currencies

What This Option Does

Currencies module manages billing/display currencies used across plans and payment-related views.

How Admin Uses This

  1. Open Currencies list.
  2. Create a currency or edit existing currency settings.
  3. Set active/default behavior if needed.
  4. Save and verify pricing/payment display output.

Screenshot Placeholder

Currencies Screenshot Placeholder
Add screenshot file at documentaion/assets/images/backoffice-currency.png

Enterprise Technical Specification

Business Capabilities

  • Currency CRUD
  • Active currency setup

API Contract Surface

Primary API endpoints used by this module:

  • /api/v1/backoffice/currencies

Permission Blueprint

Recommended permission keys for production role design:

  • backoffice.currency.view
  • backoffice.currency.create
  • backoffice.currency.edit
  • backoffice.currency.delete

Operational Risk and Control Notes

  • Currency misconfiguration affects financial totals
  • Enable activity logging and include company_id, actor ID, and target entity ID in audit traces.
  • Apply least-privilege principle for create/update/delete actions.

QA Verification Checklist

  • Validate list API load, empty-state behavior, and pagination consistency.
  • Verify create/update/delete response contract (status, message, data).
  • Confirm permission denial responses for unauthorized roles.
  • Test edge inputs and invalid IDs for safe error handling.