CHcheckout
Cardholder access tokens

Request an access token

OAuth endpoint to exchange your access key ID and access key secret for an access token.

post/issuing/access/connect/token

Request

Request body application/x-www-form-urlencoded

grant_type'client_credentials'
client_idstring

Access key ID.

client_secretstring

Access key secret.

cardholder_idstring

The cardholder's unique identifier.

single_useboolean

Specifies if the request is for a single-use token. Single-use tokens are required for sensitive endpoints.

Example request

{
  "grant_type": "client_credentials",
  "cardholder_id": "crh_d3ozhf43pcq2xbldn2g45qnb44",
  "single_use": true
}

Response

Cardholder access token retrieved successfully

access_tokenstring
token_typestring
expires_innumber

The remaining time the access token is valid for, in seconds.

scopestring

Example response

{
  "access_token": "2YotnFZFEjr1zCsicMWpAA",
  "token_type": "example",
  "expires_in": 3600,
  "scope": "issuing:card-management-write issuing:card-management-read"
}

Changes

No recorded changes to this operation across all 1 revision of this API.