v1

latestOpenAPI 3.1.02026-07-26165182724.7 KB

Create Card

Create a Virtual or a Physical Card for a user

post/card/create

Headers

api-keystring required

api-key is available in the dashboard

Authorizationstring required

Request body

userIdstring required

Unique Id of the user for whom this card is being created

nameOnCardstring required

The name of the individual that the card is associated with - A string up to 40 characters in length, containing only valid Latin characters (a-z, A-Z).

threeDSecurePasswordstring required

A strong password used to authenticate this card on online transactions - 8-36 characters containing only the allowed charset A-Z a-z 0-9 ! " # ; : ? & * ( ) + = / \ , . [ ] { }

type'VIRTUAL' | 'PHYSICAL' required

Depicting whether this card is a Virtual one or a Physical one. Physical cards will be shipped automatically once created.

accountIdToLinkstring

Optional parameter specifying which account this card is to be linked to. If not specified, it will be linked to default wallet euro account

personalizationCodestring

OPTIONAL - On production, if you have more than one card design, use this parameter to select the card design you want to use for this card. ONLY for PHYSICAL cards. A string of up to 10 characters in length.

Response

200

namestring

idstring

typestring

userIdstring

maskedCardNumberstring

expiryDatastring

statusstring

isEnrolledFor3dSecureboolean

isCard3dSecureActivatedboolean

activatedAtstring

linkedAccountIdstring

parentWalletIdstring

createdAtstring

Example response

{
  "name": "Breana Bergstrom",
  "id": "dc781476-5a6a-494f-b5a4-f1b904e24cb0",
  "type": "VIRTUAL",
  "userId": "7ea299d5-ffa8-4782-8331-2b7d61c0c730",
  "maskedCardNumber": "474367******2499",
  "expiryData": "2025-10-31T23:59:59Z",
  "status": "ACTIVE",
  "address": {
    "addressLine1": "Burger Street 2",
    "postalCode": "123331",
    "city": "Dresden",
    "country": "DEU"
  },
  "isEnrolledFor3dSecure": true,
  "isCard3dSecureActivated": true,
  "security": {
    "contactlessEnabled": true,
    "withdrawalEnabled": true,
    "internetPurchaseEnabled": true,
    "overallLimitsEnabled": true
  },
  "activatedAt": "2023-10-27T10:53:59Z",
  "linkedAccountId": "d8a8c7c7ceeec2c221971febd00d5685",
  "parentWalletId": "0cb9da83-1252-4add-9290-e9458baf2892",
  "createdAt": "2023-10-27T10:53:59Z",
  "fee": {
    "ourFee": "0",
    "theirFee": "2034",
    "amount": "2034",
    "feeCurrency": "BTC",
    "currency": "BTC",
    "cardCreationFee": {
      "amount": "66",
      "currency": "EUR"
    },
    "cardDeliveryFee": {
      "amount": "0",
      "currency": "EUR"
    },
    "exchangeRate": "32439.5"
  }
}