Skip to main content

Platform Tokens with Cards

Exact Platform Tokens allow the creation of a token representing a customer's card details. The token type is not format preserving. The Exact token can also store other data such as billing address.

When creating a platform token, we will perform an authorization for $0.00 to verify the card details.

Create Platform Tokens​

Platform tokens are created by sending request to the POST /payment-method endpoint.

Clients should submit a JSON request as follows:

Request: Create Platform Token
POST /payment-method
{
  "type": "card",
  "card": {
    "expiry": {
      "month": 9,
      "year": 2024
    },
    "number": "4111111111111111",
    "cvc": "123",
    "cvcIndicator": "present",
    "tokenType": "platform"
  },
  "billingDetails": {
    "address": {
      "line1": "7272 E Indian School Rd",
      "city": "Scottsdale",
      "state": "AZ",
      "postalCode": "85251",
      "country": "USA"
    },
    "name": "John Doe",
    "email": "[email protected]",
    "phone": "5551234567"
  }
}
Response: Create Platform Token
{
  "type": "card",
  "token": "054f3ce9-ad96-4306-abcc-5722e5313a71",
  "updatedAt": "2023-07-11T22:44:23.507Z",
  "createdAt": "2023-05-18T00:33:35.958Z",
  "billingDetails": {
    "email": "[email protected]",
    "name": "John Doe",
    "phone": "5551234567",
    "address": {
      "city": "Scottsdale",
      "country": "USA",
      "line1": "7272 E Indian School Rd",
      "postalCode": "85251",
      "state": "AZ"
    }
  },
  "card": {
    "brand": "visa",
    "lastFour": "1111",
    "checks": {
      "cvcCheck": "full-match",
      "addressCheck": "not-verified"
    },
    "expiry": {
      "month": 9,
      "year": 2024
    },
    "tokenType": "platform"
  }
}