Skip to content

feat(cards): declare card error codes in Error400/Error409 enums #814

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
kphurley7 merged 1 commit into from
Aug 10, 2026
+24 −0
Merged

feat(cards): declare card error codes in Error400/Error409 enums #814

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions mintlify/openapi.yaml
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

8 changes: 8 additions & 0 deletions openapi.yaml
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 2 additions & 0 deletions openapi/components/schemas/errors/Error400.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,7 @@ properties:
| STABLECOIN_PROVIDER_ACCOUNT_INVALID | The stablecoin provider account link is not usable |
| STABLECOIN_PROVIDER_ACCOUNT_REVOKED | The stablecoin provider account link has been revoked |
| STABLECOIN_PROVIDER_ACCOUNT_SELECTION_REQUIRED | Multiple active provider account links exist; pass `stablecoinProviderAccountId` to select one |
| CARDHOLDER_KYC_NOT_APPROVED | The cardholder's KYC status is not `APPROVED`, so a card cannot be issued |
enum:
- INVALID_INPUT
- END_USER_TERMS_VERSION_NOT_FOUND
Expand Down Expand Up @@ -95,6 +96,7 @@ properties:
- STABLECOIN_PROVIDER_ACCOUNT_INVALID
- STABLECOIN_PROVIDER_ACCOUNT_REVOKED
- STABLECOIN_PROVIDER_ACCOUNT_SELECTION_REQUIRED
- CARDHOLDER_KYC_NOT_APPROVED
message:
type: string
description: Error message
Expand Down
6 changes: 6 additions & 0 deletions openapi/components/schemas/errors/Error409.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,9 @@ properties:
| PASSKEY_ALREADY_ENROLLED | The customer already has an enrolled passkey factor; only one passkey per customer is supported. Delete the existing one before enrolling another |
| SCA_SESSION_REQUIRED | The customer's Strong Customer Authentication login session is missing or expired. Re-authenticate the customer, then retry the request. Distinct from a `401`, which means the platform's own API credentials were rejected |
| BENEFICIARY_TRUSTED | The external account is currently a trusted beneficiary, so it cannot be deleted. Untrust it first via `POST /customers/external-accounts/{externalAccountId}/untrust` (and its `/confirm`), then delete |
| INVALID_STATE_TRANSITION | The requested card `state` transition is not one of `ACTIVE ⇄ FROZEN` or `ACTIVE \| FROZEN → CLOSED` |
| CARD_ALREADY_CLOSED | `state: CLOSED` was requested for a card that is already `CLOSED` |
| CARD_NOT_MUTABLE | The card is `CLOSED`, so it can no longer be mutated |
| CONFLICT | Generic resource-state conflict. Returned, for example, when `platformCustomerId` on a customer create call collides with an existing active customer on the same platform |
enum:
- TRANSACTION_NOT_PENDING_PLATFORM_APPROVAL
Expand All @@ -32,6 +35,9 @@ properties:
- PASSKEY_ALREADY_ENROLLED
- SCA_SESSION_REQUIRED
- BENEFICIARY_TRUSTED
- INVALID_STATE_TRANSITION
- CARD_ALREADY_CLOSED
- CARD_NOT_MUTABLE
- CONFLICT
message:
type: string
Expand Down
Loading