v1

latestOpenAPI 3.1.02026-07-242325051.4 MB
AuthenticationToken

AuthenticationToken:Get

Get the details of a specific authentication token. Note you need to have access to the merchant if the authentication token is not available under your own merchant registration

get/v2/authenticationtokens/{authenticationTokenCode}

Path parameters

authenticationTokenCodestring required

Provide the AT-code of the authentication token you want to update.

Response

OK

codestring

The AT-code for an authentication token.

secretstring

A 40 character secret

namestring

The description of the token

authorisation'all' | 'specified'

Specify which kind of authorisation is applicable for the token all: all merchant rights specified: specify which authorisation groups should be enabled from the token. At least one authorisation group (in the authorisationGroups array) is mandatory

authorisationGroupsobject

The authorisation group codes

createdAtstring date-time nullable

The date and time at which this entity was created in ISO-8601 (ATOM) notation

createdBystring nullable

The reference to an account or token whom created the entity

modifiedAtstring date-time nullable

The date and time at which this entity was modified in ISO-8601 (ATOM) notation.

modifiedBystring nullable

The reference to an account or token whom modified this entity

deletedAtstring date-time nullable

The date and time at which this entity was deleted in ISO-8601 (ATOM) notation.

deletedBystring nullable

The reference to an account or token whom deleted the entity

Example response

{
  "code": "AT-1233-1322",
  "secret": "95c4ae0613c23435089dc0b480d98ce786a4e22a",
  "name": "The description of the token",
  "merchant": {
    "code": "M-1234-4321",
    "name": "GMS Demo Merchant",
    "status": "ACTIVE"
  },
  "authorisation": "specified",
  "ipFilter": {
    "type": "DENY_FROM_ALL"
  },
  "createdAt": "2024-06-04T08:15:00+01:00",
  "createdBy": "A-1234-4321",
  "modifiedAt": "2024-06-04T08:15:00+01:00",
  "modifiedBy": "A-1234-4321",
  "deletedAt": "A-1234-4321",
  "deletedBy": "A-1234-4321"
}