Card 360 Login

This API Issues an access token for a registered OAuth client. Card 360 forwards the client id and client secret to Passport using the client-credentials grant, then returns the Passport token in camel case.

ItemValue
MethodPOST
URL/card-management/login
HeaderContent-Type: application/json
AuthenticationNone. /login is permitted without a bearer token.

Request Parameters description

Field #Field nameData typeRequiredDescription
1clientIdstringtrueMust not be blank. Sent to Passport as the basic-auth username.
2clientSecretstringtrueMust not be blank. Sent to Passport as the basic-auth password.
3scopestringtrueMust not be blank. Sent to Passport as the scope form field

POST /card-management/login HTTP/1.1
Host: {host} 
Content-Type: application/json
{ 
  "clientId": "your-client-id",
  "clientSecret": "your-client-secret",
  "scope": "profile" 
}

Response Message  field description

Field #Field nameTypeDescription
1accessTokenstringPassport access_token. Use this value on Get Card Production Status.
2tokenTypestringPassport token_type. bearer when Passport omits the field.
3expiresInnumberPassport expires_in, in seconds. 3600 when Passport omits the field.
4scopestringPassport scope

Sample Response (Success)

{ 
   "accessToken": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.example.signature",
   "tokenType": "bearer", 
   "expiresIn": 3600, 
   "scope": "profile" 
}

Sample Response (Error)

HTTP 400, blank or missing field. code is 400. description is the list of validator messages. Each entry in errors has message and fieldName. The default message for a blank field is must not be blank.

{ 
  "code": "400",
  "description": "[must not be blank]",
  "correlationId": "",
  "errors": [ 
    {
      "message": "must not be blank",
      "fieldName": "clientId" 
    } 
  ]
}

The same body shape is returned when clientSecret or scope is missing. fieldName names the missing field.

HTTP 400, body is not JSON. code is 400 BAD_REQUEST. description describes the parse or type error.

Passport rejection. Card 360 returns the HTTP status it received from Passport. code is that status text, for example 401 UNAUTHORIZED, and description is the Passport error text.


Did this page help you?