Add end-user terms consent customer APIs

[bsiaotickchong]

Summary

• add the full optional endUserTermsConsent object to customer create, update, and response schemas
• expose the current Grid-hosted terms URL and version through GET /customers/end-user-terms
• remove the redundant dedicated customer-consent GET/PATCH operations and the hasAcceptedEndUserTerms boolean
• document consent requirements for unregulated platforms and the END_USER_TERMS_NOT_ACCEPTED quote error
• identify terms versions sequentially (V1, then V2, V3, …)

Validation

• make lint

Requested by @bsiaotickchong

Original PR: #788

[vercel]

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

2 Skipped Deployments

Project	Deployment	Actions	Updated (UTC)
grid-flow-builder	Ignored	Preview	Aug 5, 2026 12:10am
grid-wallet-demo	Ignored	Preview	Aug 5, 2026 12:10am

[lightspark-bot]

• Add end-user terms consent customer APIs #798 👈 (View in Graphite)
• main

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

[github-actions]

✱ Stainless preview builds for grid

This PR will update the grid SDKs with the following commit messages.

cli

feat(api): add end user terms methods and consent field to customers

go

feat(api): add end user terms consent methods and fields to customers

kotlin

feat(api): add end user terms methods and consent fields to customers

openapi

feat(api): add end user terms consent/retrieval endpoints and fields to customers

php

feat(api): add end user terms methods, endUserTermsConsent param, hasAcceptedEndUserTerms field

python

feat(api): add end-user terms consent methods/fields to customers

ruby

feat(api): add end user terms methods/models/fields to customers

typescript

feat(api): add end-user terms endpoints and consent tracking to customers

Edit this comment to update them. They will appear in their respective SDK's changelogs.

✅ grid-typescript studio · code · diff

Your SDK build had at least one "note" diagnostic, but this did not represent a regression.
generate ✅ → build ✅ → lint ❗ → test ✅

npm install https://pkg.stainless.com/s/grid-typescript/332adb2915c7ca37a9892c4c55fad7218adec2aa/dist.tar.gz

✅ grid-kotlin studio · code · diff

Your SDK build had at least one "warning" diagnostic, but this did not represent a regression.
generate ⚠️ → build ✅ → lint ✅ → test ❗

✅ grid-python studio · code · diff

Your SDK build had at least one "note" diagnostic, but this did not represent a regression.
generate ✅ → build ✅ → lint ❗ → test ❗

pip install https://pkg.stainless.com/s/grid-python/6f7b8357323a0f6c1dd6cf3ff7823a5e574de366/grid-0.0.1-py3-none-any.whl

✅ grid-openapi studio · code · diff

Your SDK build had at least one "warning" diagnostic, but this did not represent a regression.
generate ⚠️

✅ grid-ruby studio · code · diff

Your SDK build had at least one "note" diagnostic, but this did not represent a regression.
generate ✅ → build ✅ → lint ✅ → test ✅

✅ grid-go studio · code · diff

Your SDK build had at least one "note" diagnostic, but this did not represent a regression.
generate ✅ → build ✅ → lint ❗ → test ❗

go get github.com/stainless-sdks/grid-go@6e6d386f4944feb97f89091cc1666da70822c141

✅ grid-cli studio · code · diff

Your SDK build had at least one "warning" diagnostic, but this did not represent a regression.
generate ⚠️ → build ❗ → lint ❗ → test ❗

✅ grid-php studio · code · diff

Your SDK build had at least one "note" diagnostic, but this did not represent a regression.
generate ✅ → lint ✅ → test ✅

---

This comment is auto-generated by GitHub Actions and is automatically kept up to date as you push.
If you push custom code to the preview branch, re-run this workflow to update the comment.
Last updated: 2026-08-05 00:15:30 UTC

[greptile-apps]

Greptile Summary

The PR extends the customer API contract with End User Terms discovery and consent-management capabilities.

• Adds endpoints to retrieve current terms and retrieve or update customer consent.
• Allows consent evidence during customer creation and exposes consent status on customer responses.
• Updates generated OpenAPI bundles, Stainless resource mappings, webhook examples, error codes, and onboarding disclosures.

Confidence Score: 5/5

The PR appears safe to merge, with the source specification, generated bundles, SDK mappings, examples, and onboarding guidance consistently representing the new consent flow.

No concrete blocking or independently actionable non-blocking defect remains after checking the shared customer contracts, alternate customer-creation path, consent schemas, generated outputs, and documentation.

Important Files Changed

Filename	Overview
openapi/components/schemas/customers/EndUserTermsConsentRequest.yaml	Defines the shared timestamp, IP address, terms-version, and acceptance-method evidence accepted during creation and consent updates.
openapi/paths/customers/customers_{customerId}_end-user-terms-consent.yaml	Adds authenticated retrieval and update operations for a customer's recorded End User Terms consent.
openapi/paths/customers/customers_end-user-terms.yaml	Adds an authenticated endpoint exposing the current terms version and hosted URL.
openapi/components/schemas/customers/Customer.yaml	Adds the required read-only hasAcceptedEndUserTerms status to shared customer responses.
openapi/components/schemas/customers/CustomerCreateRequest.yaml	Allows individual and business customer creation requests to include consent evidence.
.stainless/stainless.yml	Maps the new models and operations into the generated customer SDK resource.
mintlify/payouts-and-b2b/onboarding/disclosures.mdx	Documents terms discovery, consent recording, retrieval, version validation, and the unregulated-platform account-opening gate.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  A[GET current End User Terms] --> B[Present terms to end user]
  B --> C{When is consent recorded?}
  C -->|During creation| D[POST /customers with endUserTermsConsent]
  C -->|After creation| E[PATCH customer consent]
  D --> F[Customer response]
  E --> F
  F --> G[hasAcceptedEndUserTerms]
  E --> H[GET recorded consent]

Loading

_{Reviews (1): Last reviewed commit: "Use sequential End User Terms version id..." | Re-trigger Greptile}

[ls-bolt]

Refactored the contract per review: consent is now embedded in customer create/PATCH/GET responses as the full endUserTermsConsent object. The dedicated consent GET/PATCH operations and hasAcceptedEndUserTerms boolean are removed. Also added END_USER_TERMS_NOT_ACCEPTED to the documented quote 403 errors. make lint passes.

[shreyav]

should we a description like "this is required if youre an unregulated platform. transactions for this customer will fail if not provided.

[shreyav]

nice ya basically whatevers in the guide in case people dont read that

[ls-bolt]

Added in 18965e9 on both customer create and update schemas. The description now states that unregulated platforms must record consent before customer-scoped transactions and that those transactions fail until consent is recorded. Rebuilt the bundled specs and make lint-openapi passes.