Add compliance context to transactions

[jklein24]

Summary

• Add an optional pendingReason field to all transactions.
• Add provider-neutral reasons for required customer action and compliance review.
• Add COMPLIANCE_REJECTED to incoming transaction failure reasons.
• Reconcile with feat!: granular counterparty payout failure reasons #689’s granular outgoing payout failure reasons, retaining its complete enum and descriptions.

Test plan

• make build
• make lint-openapi (0 errors)

Original PR: #822

[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 13, 2026 9:11pm
grid-wallet-demo	Ignored	Preview	Aug 13, 2026 9:11pm

[lightspark-bot]

• Add compliance context to transactions #823 👈 (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: Add compliance context to transactions

go

feat: Add compliance context to transactions

kotlin

feat: Add compliance context to transactions

openapi

feat(api): add pendingReason field and COMPLIANCE_REJECTED enum to transactions

php

feat: Add compliance context to transactions

python

feat: Add compliance context to transactions

ruby

feat: Add compliance context to transactions

typescript

feat: Add compliance context to transactions

⚠️grid-openapistudio · code

Your SDK build had at least one "warning" diagnostic.
generate ⚠️

✅ grid-rubystudio · code

Your SDK build had at least one "note" diagnostic.
generate ✅ → build ✅ → lint ✅ → test ✅

⚠️grid-gostudio · code

Your SDK build had a failure in the lint CI job, which is a regression from the base state.
generate ✅ → build ✅ → lint ❗ → test ❗

go get github.com/stainless-sdks/grid-go@c9ad213594940df9c9bb58ec790e656d10df8607

⚠️grid-kotlinstudio · code

Your SDK build had a failure in the test CI job, which is a regression from the base state.
generate ⚠️ → build ✅ → lint ✅ → test ❗

✅ grid-typescriptstudio · conflict

Your SDK build had at least one note diagnostic.

⚠️grid-pythonstudio · code

Your SDK build had a failure in the lint CI job, which is a regression from the base state.
generate ✅ → build ✅ → lint ❗ → test ❗

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

✅ grid-phpstudio · code

Your SDK build had at least one "note" diagnostic.
generate ✅ → lint ✅ → test ✅

⚠️grid-clistudio · code

Your SDK build had a failure in the test CI job, which is a regression from the base state.
generate ⚠️ → build ⏭️ → 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-14 15:52:39 UTC

[greptile-apps]

Greptile Summary

 ⚡ .-=========-.
/_\ | GRID API | /\
(___) | METAL MODE | ( )
| | '====|======' \/
__| |__ __| |__ _||_
/_______\ /_______\ /____\

Raise the compliance gates—let the transaction schemas thunder.

This PR extends transaction metadata with optional pending-context and new compliance-rejection failure reasons.

• Adds provider-neutral pending-reason enum values for customer action and compliance review.
• Adds COMPLIANCE_REJECTED to incoming and outgoing failure-reason schemas.
• Regenerates the root and Mintlify OpenAPI bundles.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains.

Important Files Changed

Filename	Overview
openapi/components/schemas/transactions/TransactionPendingReason.yaml	Adds the shared enum describing customer-action and compliance-review pending reasons.
openapi/components/schemas/transactions/Transaction.yaml	Adds the optional pendingReason property to the shared transaction schema.
openapi/components/schemas/transactions/IncomingTransactionFailureReason.yaml	Adds COMPLIANCE_REJECTED for incoming transactions.
openapi/components/schemas/transactions/OutgoingTransactionFailureReason.yaml	Adds COMPLIANCE_REJECTED for outgoing transactions.
openapi.yaml	Regenerates the bundled OpenAPI contract from the modular source.
mintlify/openapi.yaml	Synchronizes Mintlify’s generated OpenAPI bundle.

_{Reviews (2): Last reviewed commit: "docs(openapi): clarify pending reason sc..." | Re-trigger Greptile}

[ls-bolt]

@greptile review

[ls-bolt]

Rebased onto current main after #689 merged and reconciled the overlap. #823 now keeps #689’s full granular outgoing failure-reason enum and descriptions, while adding only the shared pendingReason contract and the incoming COMPLIANCE_REJECTED value. make build is reproducible and make lint-openapi reports 0 errors.

[shreyav]

i think jason just added this so might need a rebase, rest lgtm

[ls-bolt]

Rebased onto current main with #689 included and reconciled the overlap. #823 now preserves #689’s complete outgoing failure-reason contract and only adds the incoming COMPLIANCE_REJECTED value plus shared pending context. make build is reproducible and make lint-openapi reports 0 errors.

[jklein24]

Looks like he did for Outgoing, but this is Incoming.

[ls-bolt]

Correct — #689 owns the outgoing contract, while this PR still needs COMPLIANCE_REJECTED on incoming deposits. The rebased diff now reflects exactly that split.

[ls-bolt]

Rebased and resolved — the current diff now preserves #689’s complete outgoing contract and keeps only the incoming compliance rejection plus shared pending context from this PR.