Skip to content

feat(internal-accounts): record the customer a platform rule-based account receives for - #1081

Open
bsiaotickchong wants to merge 3 commits into
mainfrom
bsiao/internal-account-on-behalf-of-customer
Open

bsiaotickchong wants to merge 3 commits into
mainfrom
bsiao/internal-account-on-behalf-of-customer

Conversation

@bsiaotickchong

@bsiaotickchong bsiaotickchong commented Sep 26, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Adds onBehalfOfCustomerId to internal accounts. A platform-owned rule-based account can now name the customer whose payments it receives, while the platform keeps owning the account.

  • InternalAccountCreateRequest.onBehalfOfCustomerId (optional): for regulated financial institutions only. Accepted only when customerId is omitted. It must name a customer of the calling platform. The customer does not need to be verified. Several accounts can name the same customer.
  • InternalAccount.onBehalfOfCustomerId: echoed on reads, and omitted for accounts that name no customer, including every customer-owned account.
  • POST /internal-accounts: a new onBehalfOfCustomer request example. The endpoint's error descriptions are unchanged.

Non-breaking: an optional request field and an optional response field.

Implementation

The server side, and the regenerated client that depends on this spec, is in lightsparkdev/webdev#34152. Merge this PR first.

Test plan

  • make build rebundles openapi.yaml and mintlify/openapi.yaml.
  • make lint-openapi: 0 errors, the same as main.

Original PR: #1080

bsiaotickchong and others added 2 commits September 26, 2026 00:23
…count receives for

Co-Authored-By: bsiaotickchong <bsiaotickchong@users.noreply.github.com>
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
…hen unset

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

vercel Bot commented Sep 26, 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 Sep 26, 2026 12:47am UTC
grid-flow-builder Ignored Ignored Preview Sep 26, 2026 12:47am UTC
grid-wallet-demo Ignored Ignored Preview Sep 26, 2026 12:47am UTC

Request Review

Copy link
Copy Markdown

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

@greptile-apps

greptile-apps Bot commented Sep 26, 2026 •

Copy link
Copy Markdown
Contributor

RetriggerConfidence Score: 5/5

[Critical risk] Adds a new field to the public API contract for internal accounts.

The specification change appears safe to merge.

Summary

Adds an optional customer association to platform-owned rule-based internal accounts.

  • Documents the field on create requests and account responses.
  • Adds a create-request example and describes the new 400 and 404 cases.

Reviews (1) · Last reviewed commit: "docs(internal-accounts): onBehalfOfCusto..."

…itutions; keep error text unchanged

Co-Authored-By: bsiaotickchong <bsiaotickchong@users.noreply.github.com>
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@mintlify

mintlify Bot commented Sep 26, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated
Grid 🟢 Ready View Preview Sep 26, 2026, 12:48 AM

This branch was successfully deployed

1 active deployment
staging - mintlify — 1afab713 Deployed Sep 26, 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