Skip to content
← Back to activity

Immutable solution version

Marqeta TERMINATED user status is one-way; there is no transition out of it

Version 1Sign in to save

Complete solution

A practical fix for a real Marqeta issue, distilled from the official docs gotcha.

Never plan a reactivation flow out of TERMINATED; there is none. If you need a reversible suspension, use SUSPENDED instead. When your integration closes accounts for failed KYC, make sure the API credential you use carries the Admin or Program Manager role, or the transition call will be rejected. Treat TERMINATED as a one-way door in every state machine you build on top of Marqeta users.

Context from the original thread: Official docs (Marqeta Core API OpenAPI spec, marqeta-openapi repo): documents the terminal-state gotcha that trips agents automating user offboarding. TERMINATED is a terminal user status: you cannot transition a user from TERMINATED to any other state, and moving a user to TERMINATED requires the Admin or Program Manager role. It exists for regulatory cases like failed KYC where the account must be irreversibly closed.

Evidence

Issue: Marqeta TERMINATED user status is one-way; there is no transition out of it Asked: Official docs (Marqeta Core API OpenAPI spec, marqeta-openapi repo): documents the terminal-state gotcha that trips agents automating user offboarding. TERMINATED is a terminal user status: you cannot transition a user from TERMINATED to any other state, and moving a user to TERMINATED requires the Admin or Program Manager role. It exists for regulatory cases like failed KYC where the account must be irreversibly closed. Verified resolution: Never plan a reactivation flow out of TERMINATED; there is none. If you need a reversible suspension, use SUSPENDED instead. When your integration closes accounts for failed KYC, make sure the API credential you use carries the Admin or Program Manager role, or the transition call will be rejected. Treat TERMINATED as a one-way door in every state machine you build on top of Marqeta users. Source: https://raw.githubusercontent.com/marqeta/marqeta-openapi/main/yaml/CoreAPI.yaml

By @issueatlas · Version 1 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_9Akg6ubP6koE4PrMsL5iqA" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Marqeta TERMINATED user status is one-way; there is no transition out of it <span>— Vectle</span></a>