Sign in

Create Card

Changed on

Register a card on a smart wallet. Returns a transaction to be signed for on-chain signer setup. Only supported on stellar-smart-wallet.

API scope required: wallets:cards.create

post/2025-06-09/wallets/{walletLocator}/cards

Request

  • Base URL: https://staging.crossmint.com/api
  • URL: https://staging.crossmint.com/api/2025-06-09/wallets/{walletLocator}/cards
  • Auth: none declared. Required headers: X-API-KEY

Path parameters

walletLocatorstring required

A wallet locator can be of the format:

  • <walletAddress>
  • email:<email>:<chainType>[:<walletType>][:alias:<alias>] (walletType defaults to 'smart')
  • userId:<userId>:<chainType>[:<walletType>][:alias:<alias>] (white label user example)
  • phoneNumber:<phoneNumber>:<chainType>[:<walletType>][:alias:<alias>]
  • twitter:<handle>:<chainType>[:<walletType>][:alias:<alias>]
  • x:<handle>:<chainType>[:<walletType>][:alias:<alias>]
  • me:<chainType>[:<walletType>][:alias:<alias>] (Use when calling from the client side with a client API key)
  • chainType[:<walletType>]:alias:<alias>

Headers

X-API-KEYstring required

API key required for authentication

Request body

Response

Card registered. Sign and submit the returned transaction.

idstring required

Crossmint-assigned card identifier (UUID), distinct from the provider's cardId.

Changes

  • 3983c72e453aRevision changes
    • info

      removed the astar-zkevm enum value from the ////// response property for the response status

    • info

      removed the base-goerli enum value from the ////// response property for the response status

    • info

      removed the coti enum value from the ////// response property for the response status

    • info

      removed the coti-testnet enum value from the ////// response property for the response status

    • info

      removed the ethereum-goerli enum value from the ////// response property for the response status

    • info

      removed the hedera enum value from the ////// response property for the response status

    • info

      removed the hedera-testnet enum value from the ////// response property for the response status

    • info

      removed the lightlink enum value from the ////// response property for the response status

    • info

      removed the lightlink-pegasus enum value from the ////// response property for the response status

    • info

      removed the mode enum value from the ////// response property for the response status

    • info

      removed the mode-sepolia enum value from the ////// response property for the response status

    • info

      removed the optimism-goerli enum value from the ////// response property for the response status

    • info

      removed the plume enum value from the ////// response property for the response status

    • info

      removed the plume-testnet enum value from the ////// response property for the response status

    • info

      removed the polygon-mumbai enum value from the ////// response property for the response status

    • info

      removed the rari enum value from the ////// response property for the response status

    • info

      removed the rari-testnet enum value from the ////// response property for the response status

    • info

      removed the soneium enum value from the ////// response property for the response status

    • info

      removed the soneium-minato-testnet enum value from the ////// response property for the response status

    • info

      removed the u2u-nebulas enum value from the ////// response property for the response status

    • info

      removed the u2u-solaris enum value from the ////// response property for the response status

    • info

      removed the viction enum value from the ////// response property for the response status

    • info

      removed the viction-testnet enum value from the ////// response property for the response status

    • info

      removed the world-chain enum value from the ////// response property for the response status

    • info

      removed the world-chain-sepolia enum value from the ////// response property for the response status

    • info

      removed the xai enum value from the ////// response property for the response status

    • info

      removed the xai-sepolia-testnet enum value from the ////// response property for the response status

    • info

      removed the zenchain-testnet enum value from the ////// response property for the response status

    • info

      removed the zkatana enum value from the ////// response property for the response status

    • info

      removed the zkyoto enum value from the ////// response property for the response status

    • info

      removed the zora-goerli enum value from the ////// response property for the response status

  • 19493bf640a4Revision changes
    • warning

      added the new arc enum value to the ////// response property for the response status

    • warning

      added the new celo enum value to the ////// response property for the response status

    • warning

      added the new celo-sepolia enum value to the ////// response property for the response status