diff --git a/mintlify/snippets/cards/intro.mdx b/mintlify/snippets/cards/intro.mdx index 5aee036c..5042a3ed 100644 --- a/mintlify/snippets/cards/intro.mdx +++ b/mintlify/snippets/cards/intro.mdx @@ -20,11 +20,12 @@ the same ledger you already use for payouts. ## Card lifecycle at a glance -A card moves through five states: +A card moves through six states: | State | Meaning | |-------|---------| | `PENDING_KYC` | Cardholder has not finished KYC; the card cannot transact yet. | +| `PENDING_AUTH` | Card is backed by an Embedded Wallet funding source and the cardholder has not yet completed delegated signing authorization via `POST /auth/delegated-keys`. The card cannot transact. | | `PROCESSING` | Card has been requested and is being provisioned with the issuer. | | `ACTIVE` | Card is live and can authorize transactions. | | `FROZEN` | Card is temporarily disabled. New authorizations are declined; in-flight settlements continue. | diff --git a/mintlify/snippets/cards/issuing-cards.mdx b/mintlify/snippets/cards/issuing-cards.mdx index f0c36bbd..9b2603c2 100644 --- a/mintlify/snippets/cards/issuing-cards.mdx +++ b/mintlify/snippets/cards/issuing-cards.mdx @@ -32,9 +32,10 @@ one currency. ## The lifecycle ```text -PROCESSING ──► ACTIVE ──► FROZEN ──► ACTIVE ──► CLOSED - │ │ ▲ - │ └──────────────────────────────┘ +PROCESSING ──► PENDING_AUTH ──► ACTIVE ──► FROZEN ──► ACTIVE ──► CLOSED + │ │ │ ▲ + │ │ └──────────────────────────────┘ + │ └──────────────────────────────────────────────┘ │ └─► CLOSED (stateReason: ISSUER_REJECTED) ``` @@ -42,7 +43,8 @@ PROCESSING ──► ACTIVE ──► FROZEN ──► ACTIVE ──► CLOSE | State | When you see it | |-------|-----------------| | `PROCESSING` | Returned synchronously from `POST /cards`. The card cannot transact yet. | -| `ACTIVE` | Issuer provisioned the card. Reached via `CARD.STATE_CHANGE` webhook. | +| `PENDING_AUTH` | Card is backed by an Embedded Wallet funding source and awaiting delegated key authorization via `POST /auth/delegated-keys`. Only appears for Embedded Wallet-funded cards. | +| `ACTIVE` | Issuer provisioned the card (and delegated key authorization completed, if applicable). Reached via `CARD.STATE_CHANGE` webhook. | | `FROZEN` | You called `PATCH /cards/{id}` with `state: "FROZEN"`. | | `CLOSED` | You called `PATCH /cards/{id}` with `state: "CLOSED"` (or the issuer rejected provisioning). Terminal. | diff --git a/mintlify/snippets/cards/webhooks.mdx b/mintlify/snippets/cards/webhooks.mdx index e2301997..5d6ec577 100644 --- a/mintlify/snippets/cards/webhooks.mdx +++ b/mintlify/snippets/cards/webhooks.mdx @@ -12,7 +12,7 @@ extends the Transaction model with a card destination type). | Type | Fires on | |------|----------| -| `CARD.STATE_CHANGE` | `PROCESSING → ACTIVE`, `→ CLOSED (ISSUER_REJECTED)`, and every subsequent `ACTIVE ⇄ FROZEN` and `→ CLOSED` transition. | +| `CARD.STATE_CHANGE` | `PROCESSING → ACTIVE`, `PROCESSING → PENDING_AUTH`, `PENDING_AUTH → ACTIVE`, `→ CLOSED (ISSUER_REJECTED)`, and every subsequent `ACTIVE ⇄ FROZEN` and `→ CLOSED` transition. | | `CARD.FUNDING_SOURCE_CHANGE` | Whenever `PATCH /cards/{id}` updates the `fundingSources` array. | All three carry the standard envelope: