Token

Token

A token representing a payment instrument.

Methods

GET

Retrieve the detail for this token.

Responses

Examples

GET
 Retrieve details about a token.
View
GET
 Retrieve details about a token with a network payment instrument.
View
GET
 Retrieve details about a token with a namespace.
View
DELETE

Delete this token.

Responses

Examples

DELETE
 Delete a token.
View

Link relationship

  • tokens:token

    A token representing a payment instrument - this resource.

  • tokens:billingAddress

    Update the billing address.

  • tokens:cardExpiryDate

    Update the card expiry date.

  • tokens:cardHolderName

    Update the card holder name.

  • tokens:description

    Update the token description.

  • tokens:schemeTransactionReference

    Update the scheme transaction reference.

  • tokens:conflicts

    Update conflicts.

  • tokens:networkToken

    Use an existing token to provision a network payment token.

get
 Retrieve details about a token.
GEThttps://try.access.worldpay.com/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXckVkRHdJSjFNQzR5VkE5NHhYUldzYz0ifQ
Copied!
{
  "Accept": "application/vnd.worldpay.tokens-v3.hal+json"
}

200

Copied!
{
  "Content-Type": "application/vnd.worldpay.tokens-v3.hal+json;charset=UTF-8"
}
Copied!
{
  "tokenPaymentInstrument": {
    "type": "card/tokenized",
    "href": "https://try.access.worldpay.com/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXckVkRHdJSjFNQzR5VkE5NHhYUldzYz0ifQ"
  },
  "tokenId": "9925760692793807595",
  "description": "Token Description",
  "tokenExpiryDateTime": "2025-01-23T10:57:01Z",
  "paymentInstrument": {
    "type": "card/masked",
    "cardNumber": "4444********1111",
    "cardHolderName": "Card Holder Name",
    "cardExpiryDate": {
      "month": 5,
      "year": 2035
    },
    "bin": "444433",
    "brand": "VISA",
    "fundingType": "credit",
    "countryCode": "US",
    "billingAddress": {
      "address1": "Address 1",
      "address2": "Address 2",
      "address3": "Address 3",
      "postalCode": "Postal Code",
      "city": "City",
      "state": "State",
      "countryCode": "XX"
    }
  },
  "_links": {
    "tokens:token": {
      "href": "https://try.access.worldpay.com/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXckVkRHdJSjFNQzR5VkE5NHhYUldzYz0ifQ"
    },
    "tokens:description": {
      "href": "https://try.access.worldpay.com/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXdW9oYzR3RUFEM2FCQnlaejhsZ1poTFVzYW1OU1lxSFE2NHI1c2JkY1pWaSJ9"
    },
    "tokens:cardHolderName": {
      "href": "https://try.access.worldpay.com/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXc2w4WnRHSGdzblFZd2Y4ZU1hLzhXT0pLN2N3VVc5WUk3czRUTW1RQ2JLdjFnVXlzakdPSXdWWkRhZkZyUmlMd3c9PSJ9"
    },
    "tokens:cardExpiryDate": {
      "href": "https://try.access.worldpay.com/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXc2w4WnRHSGdzblFZd2Y4ZU1hLzhXT0pLN2N3VVc5WUk3czRUTW1RQ2JLdkVpVW5GNnBsZThNTXNQWTRGbzFzTXc9PSJ9"
    },
    "tokens:billingAddress": {
      "href": "https://try.access.worldpay.com/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXc2w4WnRHSGdzblFZd2Y4ZU1hLzhXTlpSdXFxbWZlNVl1TkpHZEVvZXN3MTlCU0lmdCtxSTUyVDJSdXlmSTIwM3c9PSJ9"
    },
    "tokens:schemeTransactionReference": {
      "href": "https://try.access.worldpay.com/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXc2w4WnRHSGdzblFZd2Y4ZU1hLzhXTThZcVl5OWJFUHNnbzNpTHd1NlpJSTJxUUNRVXZybWJpRkdyQ0NNQ0g0ZlpsNlBnc1NkL0h5VkRCKyt0Ym9wMGs9In0"
    },
    "tokens:networkToken": {
      "href": "https://try.access.worldpay.com/tokens/network"
    },
    "curies": [
      {
        "href": "https://try.access.worldpay.com/rels/tokens/{rel}.json",
        "name": "tokens",
        "templated": true
      }
    ]
  }
}