Implement multi-currency invoicing with automatic FX conversion

[Smartdevs17]

Context

Invoices need multi-currency support with FX conversion.

Current Limitation

Invoices are single-currency only.

Expected Outcome

• Multi-currency invoice generation
• Automatic FX conversion
• FX rate caching
• Multi-currency reporting

Acceptance Criteria

• Multi-currency invoice generation
• Automatic FX conversion at payment time
• FX rate caching with TTL
• Multi-currency reporting
• FX rate alerts
• FX history tracking
• FX documentation

[Tobi-8]

@Tobi-8 has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

hey maintainer, i don't know if you'll see this but i have applied to several of your issue, and i haven't received none, but i hope i'll be able to eventually receive one from you

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Tobi-8 to this issue.

[ryal-net01]

@ryal-net01 has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

I'm a Software Engineer and I'd like to work on this issue.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @ryal-net01 to this issue.

[directorfloo]

@directorfloo has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

I would love to work on this issue professionally, please assign it to me

ℹ️ Repo Maintainers: To accept this application, review their application or assign @directorfloo to this issue.

[devsimze]

@devsimze has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Hi I'd like to work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @devsimze to this issue.

[david87131]

@david87131 has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Please can you assign this to me
Thank you very much

ℹ️ Repo Maintainers: To accept this application, review their application or assign @david87131 to this issue.

[Aesdecodes]

@Aesdecodes has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

I’d like to work on this issue because multi-currency invoicing is a key capability for global payment platforms. Implementing accurate FX conversion, rate caching, and reporting will improve the user experience while ensuring consistency across invoices and payments. I’m comfortable working with backend financial systems and API integrations, and I can deliver a reliable, well-structured solution with proper caching, documentation, and test coverage.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Aesdecodes to this issue.

[drips-wave]

Congratulations, @devsimze! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on July 30, 2026.

🧑‍💻 @devsimze: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[drips-wave]

This issue has been completed by @devsimze as part of the Stellar Wave Program's 7th Wave 🥳

😎 @devsimze: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here. You can also Leave a review to share your experience working on this issue.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.