Skip to content

docs: update crypto wallet beneficiary documentation for Travel Rule - #839

Open
claude[bot] wants to merge 1 commit into
mainfrom
docs/sync-20260815
Open

docs: update crypto wallet beneficiary documentation for Travel Rule#839
claude[bot] wants to merge 1 commit into
mainfrom
docs/sync-20260815

Conversation

@claude

@claude claude Bot commented Aug 15, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Updated crypto wallet external account documentation to reflect optional beneficiary support for Travel Rule compliance
  • First-party wallets (self-custody) don't require beneficiary info—Grid uses customer's verified identity
  • Third-party wallets on platforms with Travel Rule requirements (e.g. EU) must include beneficiary object

Changes

Documentation (2 files):

  • mintlify/snippets/external-accounts.mdx - Updated Cryptocurrency tab note
  • mintlify/ramps/accounts/external-accounts.mdx - Updated on-ramp destination bullets

Context

This syncs documentation with schema changes in commit 3ad6a07 which added the beneficiary field to WalletBeneficiaryFields.yaml for crypto wallet external accounts.

Test plan

  • Ran make lint - passes with only pre-existing warnings
  • Preview the docs to verify the note renders correctly

🤖 Generated with Claude Code

Update documentation to reflect that crypto wallet external accounts now
support optional beneficiary information for Travel Rule compliance:

- First-party wallets (customer's self-custody) don't require beneficiary
  info—Grid uses the customer's verified identity
- Third-party wallets on platforms with Travel Rule requirements (e.g. EU)
  must include a beneficiary object with beneficiaryType, fullName, and
  countryOfResidence

This syncs the docs with schema changes in commit 3ad6a07.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Aug 15, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
Grid 🟢 Ready View Preview Aug 15, 2026, 8:12 AM

@vercel

vercel Bot commented Aug 15, 2026

Copy link
Copy Markdown

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

2 Skipped Deployments
Project Deployment Actions Updated (UTC)
grid-flow-builder Ignored Ignored Aug 15, 2026 8:10am
grid-wallet-demo Ignored Ignored Aug 15, 2026 8:10am

Request Review

@greptile-apps

greptile-apps Bot commented Aug 15, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

Updates crypto-wallet external-account documentation to explain when Travel Rule beneficiary information is optional or required.

  • Distinguishes first-party wallets, which use the customer’s verified identity, from qualifying third-party wallets.
  • Adds beneficiary guidance to the shared external-account snippet and on-ramp destination summaries.

Confidence Score: 4/5

The beneficiary field guidance should be corrected before merging because business beneficiaries following it will construct an invalid request.

The shared note treats individual beneficiary fields as universal despite the API’s distinct business-beneficiary schema, while the on-ramp summary also drops a relevant third-party qualification.

Files Needing Attention: mintlify/snippets/external-accounts.mdx; mintlify/ramps/accounts/external-accounts.mdx

Important Files Changed

Filename Overview
mintlify/snippets/external-accounts.mdx Adds detailed Travel Rule guidance, but incorrectly prescribes individual-only fields for business beneficiaries.
mintlify/ramps/accounts/external-accounts.mdx Updates on-ramp beneficiary messaging, with one summary bullet omitting the third-party exception stated elsewhere on the page.
Prompt To Fix All With AI
### Issue 1
mintlify/snippets/external-accounts.mdx:1825-1826
**Business beneficiary fields are wrong**

When the third-party beneficiary is a business, this guidance prescribes the individual-only `fullName` and `countryOfResidence` fields instead of the required `legalName`, causing customers following the documentation to submit an invalid beneficiary object.

### Issue 2
mintlify/ramps/accounts/external-accounts.mdx:288
**Summary omits third-party exception**

This general on-ramp summary describes beneficiary information as optional without the third-party Travel Rule exception included earlier on the page, leaving readers who use this section as a quick reference with incomplete compliance guidance.

---

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

Reviews (1): Last reviewed commit: "docs: update crypto wallet beneficiary d..." | Re-trigger Greptile

Comment on lines +1825 to +1826
platforms with Travel Rule requirements (e.g. EU) must include a `beneficiary`
object with `beneficiaryType`, `fullName`, and `countryOfResidence`. Send only

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.

P1 Business beneficiary fields are wrong

When the third-party beneficiary is a business, this guidance prescribes the individual-only fullName and countryOfResidence fields instead of the required legalName, causing customers following the documentation to submit an invalid beneficiary object.

Prompt To Fix With AI
This is a comment left during a code review.
Path: mintlify/snippets/external-accounts.mdx
Line: 1825-1826

Comment:
**Business beneficiary fields are wrong**

When the third-party beneficiary is a business, this guidance prescribes the individual-only `fullName` and `countryOfResidence` fields instead of the required `legalName`, causing customers following the documentation to submit an invalid beneficiary object.

---

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


- **Instant delivery**: Spark wallets receive Bitcoin within seconds
- **No KYC required**: Self-custody wallets don't need beneficiary info
- **Beneficiary optional**: First-party wallets use the customer's verified identity

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 Summary omits third-party exception

This general on-ramp summary describes beneficiary information as optional without the third-party Travel Rule exception included earlier on the page, leaving readers who use this section as a quick reference with incomplete compliance guidance.

Knowledge Base Used: Mintlify Documentation Site

Prompt To Fix With AI
This is a comment left during a code review.
Path: mintlify/ramps/accounts/external-accounts.mdx
Line: 288

Comment:
**Summary omits third-party exception**

This general on-ramp summary describes beneficiary information as optional without the third-party Travel Rule exception included earlier on the page, leaving readers who use this section as a quick reference with incomplete compliance guidance.

**Knowledge Base Used:** [Mintlify Documentation Site](https://app.greptile.com/lightspark/-/custom-context/knowledge-base/lightsparkdev/grid-api/-/docs/mintlify-docs-site.md)

---

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!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants