...
1/ University checks in its internal information system whether the student already has ISIC/ITIC/ALIVE card or whether he had a card in the past. In case the stuednt is not found, the university creates a cardholder using POST /cardholders.set and saves cardholder_id for further usage. Each future action with this cardholder should be called using corresponding cardholder_id. Also, if any personal data regarding this cardholder is updated within school information system during the term, corresponding cardholder should be updated through POST /cardholders.set endpoint, using his cardholder_id.
2/ University uploads photo for a cardholder (optional) using POST /cardholders.setPhoto. This step is not mandatory, the card can be issued also without any photo. In such case, the student needs to proactively upload the photo through mobile ALIVE App to be able to use the digital card.
...
4/ When the order is completed and paid, the student receives email with his /her card number and additional information how to display this card within ALIVE App mobile application. Using it, he /she can activate digital card within mobile ALIVE App.
...
Important: Once a cardholder is created, the university should immediately save its cardholder_id which is returned through the API. Any further operation with the same cardholder should be done using this cardholder_id, not creating anothe one.
How to change validity of existing card
0/ In summer months, the university can offer to its students/teachers/staff the possibility of validity extension. The validity extension should be offere offered only to those who have valid or expired card.
1/ In case the student asks for the card to be revalidated, the university should call POST /cards.selfChangeValidityRequest. Within the response, the URL link is returned. The API returns link for order completion and payment. This link should be displayed/emailed to the student to complete the order for validity extension and to pay for it.
...