Skip to main content

Create a debit card

POST 
/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

    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

    collateralWalletId string

    ID of existing collateral wallet to use (optional)

    walletId string

    The wallet ID for debit cards

    creditLineId string

    ID of the credit line to link this credit card to (required for credit cards)

    profile

    object

    firstName string

    First name of the cardholder

    lastName string

    Last name of the cardholder

    dob string

    Date of birth in ISO format (YYYY-MM-DD)

    street1 string

    Street address line 1 of the cardholder

    street2 string

    Street address line 2 of the cardholder

    cityCountry string

    City and country of the cardholder

    stateRegion string

    State or region of the cardholder

    zip string

    ZIP/Postal code of the cardholder

    countryCode string

    Country code of the cardholder

    cellNumber string

    Cell phone number of the cardholder

    email string

    Email of the cardholder

    occupation string

    Occupation of the cardholder

    nameOnCard string

    Name to be printed on the card

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...