Sumvin’s card issuing surface gives you a card record, a funding wallet, and a managed lifecycle, scoped to a Sumvin user.
Why this exists
Card-network rails — issuance, PAN delivery, transaction streams — are not something a partner integrates against directly. Sumvin holds the user binding, the lifecycle state machine, and the on-chain wallet that backs spend, then exposes a single API for partners to drive the card forward. End-to-end issuance through the network sits behind a partner integration; the surface partners build against today is the lifecycle management layer and the funding wallet that backs it.
The pieces
| Piece | What it is | Status |
|---|
| Card Management API | List, get, freeze, unfreeze, report lost, report stolen, activate. The state machine for an issued card. | Shipped |
| Funding wallets | The Safe smart account on the card’s chain. Value in the wallet is what the card draws on. | Shipped |
| Baanx issuance | The external rail that turns a Sumvin card record into a Visa-branded debit card. | Early access |
The Card Management API and funding wallets are generally available today. End-to-end Baanx issuance is an early-access rail — partners lining up now help shape the issuance spec and secure a place in the launch cohort. Contact your account manager to scope your rollout.
How a card composes
┌────────────────────────┐
│ Card │ id, last_four, brand, exp, state
│ external_id │
│ linked_wallet_id ─────┼───┐
│ status (state machine)│ │
└────────────────────────┘ │
▼
┌────────────────────────┐
│ Funding wallet │ Safe smart account
│ address (0x…) │ on the card's chain
│ chain_id │
└────────────────────────┘
│
▼
┌────────────────────────┐
│ Safe on Sei │ Sei is the launch chain
│ EIP-1271 verification │ (chain ID 1329)
│ Agent-signed actions │
└────────────────────────┘
The card record carries identifying metadata and a state. The funding wallet is a Safe smart account on the card’s chain — there is no credit line, so balance in the wallet is what authorises a transaction.
Where to start
| Concern | Where to go | When |
|---|
| Card lifecycle | Card management API | Freeze, unfreeze, report lost or stolen, activate |
| Funding wallet | Funding wallets | When the card needs balance to authorise a transaction |
| Conceptual model | Card issuing concept | Before integrating — read this first |
| Reference app | Crypto wallet card | If you’re building the consumer surface this unlocks |