...

This document describes API for Individual Sales Service (also referred to with abbreviation ISS) in the information system ALIVE Platform. API for Individual Sales Service was developed for card issuers (mostly universities) that issue digital only cards by themselves, but the student pays for the card from his/her side through online payment gategateway. The API also allows to manage cardholders, card validity, status and other related parameters.

...

3/ University sends API request for new card issuance or for validty validity extension.

4/ The API returns back URL for a website, where the student (cardholder) puts additional personal data, contact data and pays for the card. Payment gate gateway with several payment method methods is integrated into the whole process.

...

Content Type
• Most of the requests and responses use JSON data format (application/json content-type). Clients should also include request header parameter Accept: application/json to receive correct response data format.
• Images are uploaded using multipart/form-data encoding type. Besides a path to the image stored in the local device (as permanent or temporary file) the request must contain also cardholder_id attribute to identify the cardholder to whom the image is being uploaded. Base64 encoded images are not supported. A direct image data format is also not supported.
• Images are downloaded as general binary data (octet-stream) with appropriate MIME Content-Type header. Base64 encoded images are not supported.

Charset
• All requests should be send sent with UTF-8 charset specified in the header.

...

API Responses

API responses contains contain from HTTP code and response body with pre-defined structure as described below. In case of error the human readable error messages should be used only for debugging purposes and are not meant to be displayed to the end users.

...

{
"message": "OK",
"data": [ {
"token": "<Bearer Token>",
"expires_in": 300
}
]
}

Cardholders

POST /cardholders.set

...

2/ When the order is completed and paid, the validity of digital card is changed automatically.

Basic flow of the process is described in the below diagram:

...

Environments and Credentials

...