Skip to content

docs: add rule-based accounts guide and document USDC support - #1242

Closed
ls-bolt[bot] wants to merge 1 commit into
mainfrom
10-27-rule-based-accounts-guide
Closed

ls-bolt[bot] wants to merge 1 commit into
mainfrom
10-27-rule-based-accounts-guide

Conversation

@ls-bolt

@ls-bolt ls-bolt Bot commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

This PR has been claimed. The active PR is now #1243.

Summary

  • Adds a concise Rule-Based Accounts guide at payouts-and-b2b/depositing-funds/rule-based-accounts, next to Internal Accounts in the "Managing accounts" nav group. It covers supported currencies, prerequisites, creating an account (USD and USDC tabs), sweep rule fields, tracking sweeps and SWEEP_* failures, and sandbox testing.
  • Documents USDC as a supported currency for POST /internal-accounts. The currency field and the endpoint description previously said rule-based accounts were USD only. Adds a usdcDepositAddress request example.
  • Links the new guide from the Internal Accounts page's next steps.

Notes

  • A USDC rule-based account returns one deposit address per network the platform supports in fundingPaymentInstructions, not a bank account number. USDC rule-based accounts are enabled per platform, separately from USD.

Test plan

  • make build and make lint pass.
  • Rendered the new page locally with mint dev (4.2.284):

Rule-based accounts page

Requested by @bsiaotickchong

@mintlify

mintlify Bot commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
Grid 🟢 Ready View Preview Oct 27, 2026, 9:35 PM

@vercel

vercel Bot commented Oct 27, 2026 •

Copy link
Copy Markdown

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

3 Skipped Deployments
Project Deployment Actions Updated
grid-cards-demo Ignored Ignored Preview Oct 27, 2026 9:53pm UTC
grid-flow-builder Ignored Ignored Preview Oct 27, 2026 9:53pm UTC
grid-wallet-demo Ignored Ignored Preview Oct 27, 2026 9:53pm UTC

Request Review

@ls-bolt ls-bolt Bot added the bolt label Oct 27, 2026
@ls-bolt

ls-bolt Bot commented Oct 27, 2026

Copy link
Copy Markdown
Contributor Author

@greptile review

Copy link
Copy Markdown

This stack of pull requests is managed by Graphite. Learn more about stacking.

@greptile-apps

greptile-apps Bot commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

RetriggerView in GreptileConfidence Score: 4/5

[Low impact] The changes reach API and product documentation only.

The PR appears safe to merge, with a non-blocking correction to the sweep failure list.

Findings

  1. P2 Sweep failure list is incomplete ▶
Fix with agent prompt
### Issue 1
mintlify/payouts-and-b2b/depositing-funds/rule-based-accounts.mdx:143-146
This list leaves out `QUOTE_EXECUTION_FAILED`. A sweep that was priced but fails before settlement reports this reason, as documented by `IncomingTransactionFailureReason`. Add it and distinguish it from failures before pricing, so developers do not build alerts or reconciliation checks that miss these failed sweeps.

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

Summary

Adds a rule-based accounts guide and documents USDC account creation.

  • Developers can follow one guide to create and track rule-based accounts.
  • The internal-account API reference now describes USDC deposit addresses.

Reviews (1) · Last reviewed commit: "docs: add rule-based accounts guide and ..." · Reviewed by Greptile

Comment on lines +143 to +146
A sweep that can't be completed fails with one of these reasons, and the funds move to the account holder's own internal account in the same currency:

- `SWEEP_AMOUNT_OUT_OF_RANGE`: The amount is below `minimumAmount` or above `maximumAmount`.
- `SWEEP_QUOTE_FAILED`: Grid couldn't price the sweep.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Sweep failure list is incomplete

This list leaves out QUOTE_EXECUTION_FAILED. A sweep that was priced but fails before settlement reports this reason, as documented by IncomingTransactionFailureReason. Add it and distinguish it from failures before pricing, so developers do not build alerts or reconciliation checks that miss these failed sweeps.

Prompt To Fix With AI
This is a comment left during a code review.
Path: mintlify/payouts-and-b2b/depositing-funds/rule-based-accounts.mdx
Line: 143-146

Comment:
**Sweep failure list is incomplete**

This list leaves out `QUOTE_EXECUTION_FAILED`. A sweep that was priced but fails before settlement reports this reason, as documented by `IncomingTransactionFailureReason`. Add it and distinguish it from failures before pricing, so developers do not build alerts or reconciliation checks that miss these failed sweeps.

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch, added QUOTE_EXECUTION_FAILED for sweeps that were priced and then failed before settlement ⚡


🤖 reinforced-asteroid-v6(#1) | Feedback

@ls-bolt
ls-bolt Bot force-pushed the 10-27-rule-based-accounts-guide branch from 689559b to c59a4da Compare October 27, 2026 21:34
@ls-bolt

ls-bolt Bot commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor Author

⚡ Review rounds — updated in place, latest first.

Round 2 · 548fd24

  • Removed the enablement note from the rule-based accounts guide, per @bsiaotickchong
Earlier rounds (1)

Round 1 · c59a4da

  • Added QUOTE_EXECUTION_FAILED to the guide's sweep failures, for sweeps that were priced and then failed before settlement (per Greptile)
  • Verified: render unchanged apart from one paragraph; make lint passed previously, and make lint-markdown fails identically on main (pre-existing)

@ls-bolt

ls-bolt Bot commented Oct 27, 2026

Copy link
Copy Markdown
Contributor Author

⚡ Review ledger

Round 1

  1. Sweep failure list omits QUOTE_EXECUTION_FAILED → FIXED: mintlify/payouts-and-b2b/depositing-funds/rule-based-accounts.mdx Track sweeps section

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ls-bolt
ls-bolt Bot force-pushed the 10-27-rule-based-accounts-guide branch from c59a4da to 548fd24 Compare October 27, 2026 21:53
bsiaotickchong added a commit that referenced this pull request Oct 30, 2026
#1243)

## Summary

- Adds a concise **Rule-Based Accounts** guide at `payouts-and-b2b/depositing-funds/rule-based-accounts`, next to Internal Accounts in the "Managing accounts" nav group. It covers supported currencies, prerequisites, creating an account (USD and USDC tabs), sweep rule fields, tracking sweeps and `SWEEP_*` failures, and sandbox testing.
- Documents **USDC** and **USDT** as supported currencies for `POST /internal-accounts`. The `currency` field and the endpoint description previously said rule-based accounts were `USD` only. Adds a `usdcDepositAddress` request example.
- Links the new guide from the Internal Accounts page's next steps.

## Notes

- A USDC rule-based account returns one deposit address per network the platform supports in `fundingPaymentInstructions`, not a bank account number. USDC and USDT rule-based accounts are enabled per platform, separately from USD.

## Test plan

- `make build` and `make lint` pass.
- Rendered the new page locally with `mint dev` (4.2.284):

![Rule-based accounts page](https://zeus.dev.dev.sparkinfra.net/prs/media/reinforced-asteroid-v6-3/1793314487686637564-rba3.png?sig=0b53427241df5e7d9cc0057f2f8856d17e58a5f627684c3af83c3534b92fabef)

Requested by @bsiaotickchong

Original PR: #1242

This branch was successfully deployed

1 active deployment
staging - mintlify — 548fd24b Deployed Oct 27, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants