v1

latestOpenAPI 3.1.02026-07-26165182724.7 KB

Replace Card

Replace card using existing card data, namely the cardholder's name, 3DS PW, delivery method, and shipping address — the same as the old card. This endpoint also re-links the card back to the same account that the previous card was linked to. Can be used for both physical and virtual card types

post/card/replace

Headers

api-keystring required

Authorizationstring required

Request body

cardIdstring

The unique Id of the card you want to fetch. The Create Card endpoint returns a cardId parameter

Response

200

namestring

idstring

typestring

userIdstring

maskedCardNumberstring

expiryDatastring

statusstring

isEnrolledFor3dSecureboolean

linkedAccountIdstring

parentWalletIdstring

createdAtstring

Example response

{
  "name": "john smith",
  "id": "6a8054c3-b9ce-443b-83ec-c44431634d60",
  "type": "PHYSICAL",
  "userId": "6890d93e-9b0f-4448-a2eb-270263edc7b7",
  "maskedCardNumber": "474367**********",
  "expiryData": "2027-01-31T23:59:59Z",
  "status": "CREATED",
  "address": {
    "addressLine1": "Test address line 1",
    "addressLine2": "Test address line 2",
    "city": "Test_city",
    "postalCode": "11030",
    "country": "EST",
    "dispatchMethod": "DHLExpress"
  },
  "security": {
    "contactlessEnabled": true,
    "withdrawalEnabled": true,
    "internetPurchaseEnabled": true,
    "overallLimitsEnabled": true
  },
  "linkedAccountId": "cf5ff50068c2ad658d73305f1e5b1bb4",
  "parentWalletId": "a82afcee-6b53-4869-a41a-df34e6b228db",
  "createdAt": "2024-01-03T12:48:01Z",
  "limits": {
    "dailyPurchase": 10000,
    "dailyWithdrawal": 350,
    "dailyInternetPurchase": 10000,
    "dailyContactlessPurchase": 10000,
    "weeklyPurchase": 15000,
    "weeklyWithdrawal": 3000,
    "weeklyInternetPurchase": 15000,
    "weeklyContactlessPurchase": 15000,
    "monthlyPurchase": 15000,
    "monthlyWithdrawal": 3000,
    "monthlyInternetPurchase": 15000,
    "monthlyContactlessPurchase": 15000,
    "transactionPurchase": 10000,
    "transactionWithdrawal": 350,
    "transactionInternetPurchase": 10000,
    "transactionContactlessPurchase": 50,
    "dailyOverallPurchase": 10000,
    "weeklyOverallPurchase": 10000,
    "monthlyOverallPurchase": 10000
  }
}