Skip to main content

Create a debit card

POST 
/v1/cards/debit

This endpoint creates a new debit card for a customer. To create a credit card, a Card Program ID is required, which will be provided to you by your Customer Success Manager.

This endpoint:

  • Creates a new card and associates it with a customer
  • Allows selection of the card type (i.e. virtual or physical)
  • Sets the card as a primary or supplementary card type
  • Establishes the card profile.

Request​

Body

required

Debit card creation data

    customerId stringrequired

    The ID of the customer for whom the card is being created

    cardProgramId stringrequired

    The ID of the card program to use

    walletId stringrequired

    The wallet ID for the debit card

    isVirtual booleanrequired

    Whether the card is virtual or physical. Virtual cards are automatically activated upon creation, while physical cards are created in a blocked state and need to be activated separately when received by the user.

    isPrimary booleanrequired

    Whether this is the primary card for the user

Responses​

The debit card was successfully created.

Schema

    traceId string
    message string

    data

    object

    id stringrequired

    The ID of the created card

    referenceNumber stringrequired

    The system card reference number

    status stringrequired

    Possible values: [ACTIVE, BLOCKED, SUSPENDED, CANCELLED]

    The status of the card

    walletId stringrequired

    The Wallet Id associated to the Card

Loading...