[Docs] Partial refunds for USD transactions

[promptless]

Open this suggestion in Promptless to view citations and reasoning process

Adds documentation for the new partial refund feature in the Payments dashboard. Documents that USD transactions support both full and partial refunds (specifying an amount up to the original charge), while non-USD transactions only support full refunds. Also clarifies refund eligibility requirements (non-test mode purchases with associated prices).

Trigger Events

stack-auth/stack-auth PR #1123: Partial refunds frontend

Promptless Research (1 GitHub PR)

• Reviewed stack-auth/stack-auth#1123

Agent Response

I've completed the documentation update for this PR.

Summary

I reviewed PR #1123 which adds partial refund functionality to the payments system, allowing admins to specify custom USD refund amounts instead of being limited to full refunds.

Documentation Update Created

I updated the Payments guide (docs/content/docs/(guides)/apps/payments.mdx) to document this new feature:

• Added a new "Issuing Refunds" subsection under the Transactions section
• Documented that USD transactions support both full and partial refunds (specifying an amount up to the original charge)
• Noted that non-USD transactions only support full refunds
• Clarified refund eligibility requirements (non-test mode purchases with associated prices)

Suggestion URL: https://app.gopromptless.ai/change-history/ec26b3ff-78d8-4ae0-818b-2ad8b29f9f85

This PR ties with #1123

---

Help us improve Promptless — If this suggestion missed the mark, please share quick feedback.

If you want Promptless to make further changes on this PR, feel free to leave a comment tagging Promptless (It won't show up in the user drop down but Promptless will get it!)

[promptless]

Citation: PR adds partial refund functionality. Key files: apps/dashboard/src/components/data-table/transaction-table.tsx (frontend refund dialog with USD amount input and validation), apps/backend/src/app/api/latest/internal/payments/transactions/refund/route.tsx (backend accepts optional amount_usd parameter with validation that amount > 0 and ≤ charged total).
View source

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
stack-backend	Ready	Preview, Comment	Feb 24, 2026 4:46pm
stack-dashboard	Ready	Preview, Comment	Feb 24, 2026 4:46pm
stack-demo	Ready	Preview, Comment	Feb 24, 2026 4:46pm
stack-docs	Ready	Preview, Comment	Feb 24, 2026 4:46pm

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
1 out of 2 committers have signed the CLA.

✅ madster456
❌ promptless[bot]
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

[coderabbitai]

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

• 🔍 Trigger a full review

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[promptless]

🔧 I noticed that some CI checks failed for this PR. I'm investigating the failures and will work on fixing them.

[promptless]

🔧 I noticed that some CI checks failed for this PR. I'm investigating the failures and will work on fixing them.

[greptile-apps]

Greptile Overview

Greptile Summary

This PR updates the Payments guide to describe the new refund UX in the Payments dashboard: USD transactions can be refunded either fully or partially by specifying an amount (up to the original charge), while non-USD transactions are documented as only supporting full refunds. It also adds a short set of eligibility requirements for when a transaction is refundable (non-test-mode purchase with an associated price), and points readers to the Transactions section for refunds.

Confidence Score: 5/5

• This PR is safe to merge; it is documentation-only and the edits are narrowly scoped.
• Only one MDX documentation file changes; no runtime code paths are affected. I did not find additional correctness issues beyond the already-discussed dependency on the underlying feature landing on the target branch.
• docs/content/docs/(guides)/apps/payments.mdx

Important Files Changed

Filename	Overview
docs/content/docs/(guides)/apps/payments.mdx	Adds an 'Issuing Refunds' subsection clarifying refund eligibility and that USD supports partial refunds while non-USD is full-only; no additional doc correctness issues found beyond the already-noted dependency on the feature landing.

Sequence Diagram

sequenceDiagram
  participant Admin as Admin (Dashboard)
  participant UI as Payments UI
  participant Docs as Payments Docs (MDX)

  Admin->>UI: Open transaction details
  UI-->>Admin: Show Refund action (full/partial based on currency)
  Admin->>Docs: Read "Issuing refunds" section
  Docs-->>Admin: Explain eligibility + refund type rules
  Admin->>UI: Attempt refund (amount optional for USD)
  UI-->>Admin: Refund submitted / error shown

Loading

[greptile-apps]

_{1 file reviewed, 1 comment}

_{Edit Code Review Agent Settings | Greptile}

[madster456]

@greptile please review again.

[greptile-apps]

_{1 file reviewed, no comments}

_{Edit Code Review Agent Settings | Greptile}