Skip to main content

Create a debit card

POST 
/cards/debit

Creates a new debit card for a customer. This endpoint:

  • Sets up debit card configuration
  • Associates the card with a customer
  • Initializes card status
  • Links to the customer's wallet

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)

    address string

    Address of the cardholder

    city string

    City of the cardholder

    stateCode string

    State code of the cardholder

    postalCode string

    Postal code of the cardholder

    country string

    Country 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 reference number of the card in i2c

    status stringrequired

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

    The status of the card

    walletId stringrequired

    The Wallet Id associated to the Card

Loading...