Public Payment Link Endpoint

[codebestia]

Background

The backend needs a public (unauthenticated) endpoint that resolves an invoice by its paymentSlug and returns the information a customer needs to complete payment, without exposing sensitive merchant or internal data.

Proposed Steps

1. Create GET /pay/:slug (public) — resolve an invoice by paymentSlug, return safe public view: slug, description, amount, token, status, merchantName, expiresAt, pricingMode
2. Return 404 if slug not found
3. Return 410 Gone if invoice status is CANCELLED, PAID, or REFUNDED
4. Return 410 Gone with { reason: "expired" } if expiresAt is in the past
5. Create POST /pay/:slug/confirm (public) — accept { payerAddress: string, txHash?: string }, create a PaymentConfirmation record (informational only — actual state driven by on-chain events)

Acceptance Criteria

• GET /pay/:validSlug on a PENDING invoice → 200 with public invoice data
• Merchant business name is included in the response
• GET /pay/:slug on unknown slug → 404
• GET /pay/:slug on CANCELLED/PAID invoice → 410
• GET /pay/:slug on expired invoice → 410 { reason: "expired" }
• POST /pay/:slug/confirm stores the confirmation and returns 202
• No auth required on either endpoint
• No sensitive merchant or internal fields are exposed

[Elizabeth-dev270]

I enjoy solving software problems and have experience in backend development, APIs, OOP, and scalable application design.

[amankoli09]

Can I work on this issue PR merge within 1hr

[jaynomyaro]

Hi! I’m a full-stack developer with a strong blockchain background. I’d love to handle this issue and can deliver a clean, reliable solution. Kindly assign it to me.

[Menjay7]

Hi! I came across this issue and would love to work on it. I have experience with similar tasks and I'm confident I can investigate, implement a clean solution, and thoroughly test it before submitting a PR. If the issue is still open, I would appreciate it if you could assign it to me. Thank you!

[gabito1451]

hi can i work on this issue ???

[leocagli]

I'd like to work on this issue, please assign me so I can begin implementation.

[stiven-skyward]

Hi! As a Cloud Engineer with strong experience in Python and building efficient APIs (like FastAPI), I am well-equipped to handle this backend feature. I can implement the Public Payment Link Endpoint, ensuring it integrates smoothly with the current invoice architecture and routing patterns. I can submit a clean PR within 24 hours. Best, Stiven.

[Dannyorji]

HI Maintainer
I will like to take this on
please assign
Thanks