[Refactor] Refactor PayoutService for Clarity

[Eniola3321]

Labels: refactor payout stellar api

Summary

Separate payout validation from payout processing.

Tasks
Create PayoutValidationService.
Create PayoutProcessingService.
Move validation logic.
Move transaction processing logic.
Keep payout status management centralized.
Update tests.
Swagger / API Integration
Document payout request DTO.
Document payout status response.
Document validation errors.
Document Stellar transaction states.
Update Swagger examples for payout endpoints.
Acceptance Criteria
Validation and processing responsibilities are separated.
Payout behavior remains unchanged.
API documentation accurately represents payout states.

[gracepeterfejokwu]

Hello maintainer I can work on this issue
please can you assign me

[Olayiwola2904]

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

I’ve reviewed the requirements and can fix the issue while making sure everything works as expected.

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

[bitstarkbridge]

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

i will like to work on this issues

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

[WALEY-OPS]

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

I'm free and have experience on this field. No time wasting, just swift work. Assign to me.

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

[collins-uzu]

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

I have reviewed this issue and understand the requirements.

I'd be happy to work on it. Please assign it to me.

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

[AdEmOnD07]

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

I will like to work on this issue

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

[Ghostcecode]

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

Hi, I've taken the time to go through the requirements and I'm confident I can put together a solution that satisfies the acceptance criteria. I'd be grateful if this could be assigned to me.

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

[JoyAdah]

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

i want to do this

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

[drips-wave]

Congratulations, @JoyAdah! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on August 31, 2026.

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