Multi-asset payment gateway

[respp]

📘 Issue Description

Implement a multi-asset payment gateway that allows merchants to accept various Stellar-based assets with dynamic routing through Stellar's DEX for optimal exchange rates.

🔍 Steps

1. Extend StellarContractService to handle path payment operations.
2. Create AssetConfigurationService for merchant asset preferences.
3. Implement asset price discovery via Stellar DEX.
4. Add asset validation and merchant balance checks.
5. Build endpoints for payment routing and asset configuration.

✅ Acceptance Criteria

• Supports at least 3 assets (XLM, USDC, custom token).
• Successfully routes payments via path payments.
• Real-time exchange rates are available.
• Merchants can configure accepted assets.
• Fallback logic handles failed path payments.

🌎 References

• Stellar Path Payments
• Stellar DEX

📜 Additional Notes

This feature is core to the platform’s mission of multi-asset payments. It will likely require backend changes and some admin UI for configuration.

[OthmanImam]

Hello,

I'm Usman Adamu, a full-stack developer.
I want to implement this task if assigned.

Best regard;
OthmanImam

[theobiabo]

Hello, I’d like to take on this feature implementation.

I’ve gone through the references listed, including Stellar Path Payments and the Stellar DEX documentation. I’ll extend the StellarContractService to support path payments and build an AssetConfigurationService to manage merchant asset preferences. The solution will dynamically route payments using Stellar’s DEX with real-time exchange rates, support XLM, USDC, and custom tokens, and include validation and fallback logic.

Quick question: the notes mention an admin UI for asset configuration, could you clarify if that already exists, or how I can access it if available?

Please assign me the issue.

[respp]

the issue is yours @yhoungdev

[theobiabo]

Thanks for assigning this to me @respp

[theobiabo]

Hey @respp, the implementation is in progress

[drips-wave]

This issue has been added to the Stellar Wave Program and is worth 150 Points.

🧑‍💻 Interested in contributing? Apply to work on this issue on Drips Wave, earn points, and receive rewards.

🤠 Repo maintainers: You can manage this issue's Points and Complexity on your Maintainer Dashboard here. Please keep an eye on applications and respond quickly 💙

ℹ️ Learn more about Drips Wave

[yinkscss]

@yinkscss has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hey,

I can take this.

I’ve worked with Stellar smart contracts and path payments before. I’ll extend StellarContractService for multi-asset support, implement asset configuration for merchants, handle price discovery via the DEX, and ensure payments route correctly with fallback logic.

I’ll ensure:

Support for XLM, USDC, and a custom token

Path payments execute reliably

Real-time exchange rates are accessible

Merchant asset preferences are configurable

Fallback logic gracefully handles failed transactions

All core functionality, backend and admin-ready, built robustly.

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

[JoE11-y]

@JoE11-y has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hi there! I’d love to pick up this issue. I understand the scope of the issue and can submit a PR soon if assigned.

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

[Oluwaseyi89]

@Oluwaseyi89 has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hi Maintainer! As an experienced blockchain developer I would like to be assigned to work on the multi-asset payment gateway to let merchants accept different Stellar assets seamlessly. I can implement path payments, real-time exchange rates via Stellar DEX, and dynamic routing to make sure payments always go through optimally. Plus, I’ll set up merchant asset configuration and fallback logic so everything runs smoothly even if a path payment fails.

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

[Chucks1093]

@Chucks1093 has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hello, I am a fullstack engineer. I’ve reviewed the repo and the issue, and here’s how I’d approach it:

• Begin by extending StellarContractService to support Stellar path payment operations so the system can route between different assets.
• Add an AssetConfigurationService that lets merchants define which assets they accept and their preferred settlement asset.
• Integrate Stellar DEX price discovery to fetch real time conversion paths and rates before executing payments.
• Validate incoming payment assets and ensure the merchant has the correct trustlines and balances before routing.
• Build API endpoints for configuring accepted assets and for initiating routed payments.
• Implement fallback logic to retry alternative paths or return a clear error when no viable path exists.
• Keep routing logic deterministic and fast so payments don’t introduce noticeable latency.

ETA: 24–36 hours

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

[popeplufi]

@popeplufi has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

I’m a full-stack developer and will implement this by extending StellarContractService to support path payments and dynamic routing via the Stellar DEX. I’ll build an asset configuration layer for merchant preferences, add real-time price discovery, and enforce asset validation and balance checks. The solution will support multiple assets (XLM, USDC, custom tokens), include fallback logic for failed routes, and expose clear APIs for payment routing and configuration—prioritizing reliability, security, and extensibility.

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