Frontend: Add Bulk Payment CSV Upload with Validation Preview

[Smartdevs17]

Context

Enterprise users process hundreds of payments at once. A single-payment form does not scale for batch operations.

Current Limitation/Problem

There is no bulk upload interface. Users must either use the API directly or submit payments one by one, which is inefficient for high-volume merchants.

Expected Outcome

A CSV/Excel upload interface with column mapping, row-level validation preview, error highlighting, and one-click execution with progress tracking.

Acceptance Criteria

• Upload CSV or Excel files with payment data
• Smart column auto-detection (amount, destination, currency, memo, etc.)
• Manual column mapping UI for non-standard headers
• Row-level validation preview showing errors and warnings
• Highlight invalid rows with tooltip explaining the issue
• Download error report CSV with correction suggestions
• Execute valid rows with progress bar (per-row status)
• Support 1000+ rows with chunked processing
• Template download for correct CSV format

Technical Scope

• frontend/src/app/payments/bulk/ - bulk upload route
• frontend/src/components/payments/bulk/ - upload components
• CSV parsing with PapaParse, Excel with SheetJS
• backend/src/services/payments/bulk-processor.ts - batch validation/execution
• Prisma: BulkUpload, BulkUploadRow models
• BullMQ queue for async bulk processing
• WebSocket progress updates
• Edge cases: encoding issues, very large files, partial failures, row limits

[Kayce10]

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

Hi maintainer, i would like to work on this issue

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

[playmaker410]

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

I’d love to take this on. I have hands-on experience with Rust, Soroban, Cairo, and TypeScript, and I’m confident I can deliver a solid solution within 24 hours.

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

[oscar24357]

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

Hello maintainer, can I work on this issue please?

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

[barnabasolutayo-lgtm]

@barnabasolutayo-lgtm has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Good morning Maintainer. I would love to resolve this issue in no time. Please assign to me. Thank you

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

[amankoli09]

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

Can i work on this issue PR merge within 1hr

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

[thewealthyplace]

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

Hi maintainer, I’d like to work on this issue.

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

[drips-wave]

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

🧑‍💻 @thewealthyplace: 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 🌊