Card Tokens represent finalized digital value created from Card Token Drafts. Once issued, a Card Token becomes a claimable asset that can be delivered to a recipient and redeemed through the CleverCards Platform to activate a digital prepaid Mastercard.
Card Tokens are central to the digital value lifecycle. They act as the bridge between your internal systems and the CleverCards infrastructure, enabling you to control how and when value is made available to end users. Tokens can be issued with usage restrictions, associated metadata, and time-based controls.
Use cases include sending instant rewards, enabling expense payments, or granting access to specific funds. Each token is unique and traceable, offering full transparency and auditability across your payment flows.
Once a token is claimed by the recipient, it is redeemed to activate a Card Account, which is then linked to a digital card.
Available Operations
The CleverCards API supports the following operations on Card Tokens:
-
POST /card-token/card-token-draft/{cardTokenDraftId}
Create a card token from a draft (by path) – Finalize the issuance process by creating a Card Token from a specific Card Token Draft. ThecardTokenDraftIdis passed directly in the URL path. This operation is suitable when the draft has already been fully defined and validated. -
POST /card-tokens
Create a card token from a draft (by body) – Alternatively, a Card Token can be created by submitting a request body that includes thedraftId. This approach is useful for more dynamic integrations where the draft ID is available at runtime.
These endpoints allow you to create tokens, while supporting operational needs such as resending tokens or reviewing issuance history. Once redeemed, a token is converted into an active card with associated balance or limits, ready for immediate use.