Get a card token

Generate a card token to enable the subsequent retrieval of the card's sensitive details including full PAN, expiry, CVV2 and embossedName.

Refer to the fetching secure card information guide for more information.

The callback URL responds with an object containing the card's sensitive details.

{
  "cvv2": "442",
  "pan": "1234123412345678",
  "expiry": "202501",
  "embossedName": "DOE/JOHN"
}

Path Parameters

• cardId string required

  ID of card for which to obtain a token

Responses

• 200
• 400

---

Successful operation

application/json

• Schema
• Example (from schema)

---

Schema

• tokenId string required

  One-time use token for card detail retrieval

• callbackUrl string required

  One-time URL which can be called to retrieve the card's secure details.

  This URL requires no authentication.

{
  "tokenId": "1E2426184B3676720F36E43A22649AFF-1000041153",
  "callbackUrl": "https://api-sec.immersve.com/api/cards/secure?tokenId=1E2426184B3676720F36E43A22649AFF-1000041153"
}

Request fields are invalid

application/json

• Schema
• Example (from schema)

---

Schema

• statusCode integer required
• statusName string required
• errorCode string required
• errors string[]

{
  "statusCode": 400,
  "statusName": "Bad Request",
  "errorCode": "BAD_REQUEST",
  "errors": [
    "Expected string, received number"
  ]
}

Loading...