Skip to content

fix(grid-visualizer): emit documented minimum beneficiary fields#417

Draft
pengying wants to merge 1 commit intomainfrom
04-28-fix_grid-visualizer_emit_documented_minimum_beneficiary_fields
Draft

fix(grid-visualizer): emit documented minimum beneficiary fields#417
pengying wants to merge 1 commit intomainfrom
04-28-fix_grid-visualizer_emit_documented_minimum_beneficiary_fields

Conversation

@pengying
Copy link
Copy Markdown
Contributor

The generated curl examples included birthDate and nationality on
every beneficiary (both are optional per docs) and omitted address
even for countries where docs say it's required. Aligns the output
with the minimum-required-fields table in the External Accounts docs:

  • All countries: emit only beneficiaryType + fullName as the universal
    minimum (drop birthDate / nationality — both are optional, "providing
    additional information... can reduce false positive compliance checks").
  • US (USD), Europe (EUR), UK (GBP): include a country-appropriate
    beneficiary.address (line1, city, postalCode, country, optional state).
  • Mexico (MXN), Brazil (BRL), Philippines (PHP): explicit
    beneficiaryAddressRequired: false — docs call out that address is not
    required for these.
  • Other account types: left undefined so the generated payload still
    emits the universal minimum, since the docs only document the
    minimum-fields table for the six countries above.

Adds BeneficiaryAddressExample type + two optional fields on
AccountTypeSpec (beneficiaryAddressRequired, beneficiaryAddressExample).
The code-generator's buildAccountInfoBody is updated to include the
address block conditionally.

Ref: https://grid.lightspark.com/payouts-and-b2b/depositing-funds/external-accounts#individual-beneficiaries

Co-Authored-By: Claude Opus 4.7 (1M context) noreply@anthropic.com

The generated curl examples included `birthDate` and `nationality` on
every beneficiary (both are optional per docs) and omitted `address`
even for countries where docs say it's required. Aligns the output
with the minimum-required-fields table in the External Accounts docs:

- All countries: emit only beneficiaryType + fullName as the universal
  minimum (drop birthDate / nationality — both are optional, "providing
  additional information... can reduce false positive compliance checks").
- US (USD), Europe (EUR), UK (GBP): include a country-appropriate
  beneficiary.address (line1, city, postalCode, country, optional state).
- Mexico (MXN), Brazil (BRL), Philippines (PHP): explicit
  beneficiaryAddressRequired: false — docs call out that address is not
  required for these.
- Other account types: left undefined so the generated payload still
  emits the universal minimum, since the docs only document the
  minimum-fields table for the six countries above.

Adds BeneficiaryAddressExample type + two optional fields on
AccountTypeSpec (beneficiaryAddressRequired, beneficiaryAddressExample).
The code-generator's buildAccountInfoBody is updated to include the
address block conditionally.

Ref: https://grid.lightspark.com/payouts-and-b2b/depositing-funds/external-accounts#individual-beneficiaries

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 28, 2026

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

Project Deployment Actions Updated (UTC)
grid-flow-builder Ready Ready Preview, Comment Apr 28, 2026 11:07pm

Request Review

Copy link
Copy Markdown
Contributor Author

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

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.

1 participant