Skip to main content

Create a credit card

POST 
/v1/cards/credit

This endpoint creates a new credit 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

Credit 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 stringrequired

    ID of existing collateral wallet to use (required for credit cards)

    creditLineId stringrequired

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

Responses​

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