Basic User Scenarios

Documentation has moved

The information on this page is no longer updated and may be obsolete. The most current Koshelek documentation is now available at the new address:

https://developers.koshelek.app/en/

Registration in the Application

The scenario is executed, if the user is not registered in the Koshelek app yet.

1. The user specifies personal data (full name, sex, date of birth).

2. The user enters a contact information (mobile phone number and email address that are used to register user's personal account in the application).

3. If the phone number already exists in the database of Koshelek app users, the authentication scenario begins.

4. In the opposite case the application starts the confirmation procedure:

   • At the specified phone number, the incoming voice call from a randomly generated phone number is arrived. The user must enter last four digits of calling number in the application.

   • For the email address confirmation, an email with a confirmation link is sent to the specified email address.

5. The user specifies a password for user's account and accepts with terms of User Agreement of the Koshelek app.

6. If the user has chosen a social network account for registration, the fast registration via the specified social network will be available for the user in the future, if the user resets application data or changes mobile device.

1. Welcome screen

2. Enter personal data

3. Enter phone number

4. Confirm phone number

5. Confirm email

6. Create password

Authentication of Registered User

The scenario is executed, if the user has a registered account in the Koshelek app but launches the Koshelek app at this device first time or after the data reset.

1. The user enters their mobile phone number and password.

2. Koshelek server looks for the registered user by the specified phone number and checks the password validity.

3. If user's phone number is found and the specified password is correct, the user is authenticated.

4. If the specified phone number is not found in the database, the user is redirected to the registration scenario.

5. If the specified password is invalid, the user is redirected to the password restoring procedure.

When the application is launched on the same device, user authentication is not required next time.

Login screen

User Profile and Settings

In the application menu (available at application's main screen) the user may specify and, if necessary, change the following personal data (profile of a registered user):

• Full name.

• Date of Birth.

• Gender.

• Email address.

When the email address is changed, a confirmation email message is sent to new address. The message contains a link for the confirmation and the user can confirm new address later.

The phone number specified in the profile cannot be changed.

User profile

Catalog

The Catalog section displays a list of available offers (loyalty cards, promos, coupons, etc.).

1. For the each offer there is the following data displayed:

   • Offer's banner image:

     • 1st format: 1080x574px — standard format for the Catalog screen.

     • 2nd format: 504x504px — for the Offer screen as a search result.

   • Product name, containing:

     • retailer name;

     • explanatory comment.

2. When the user taps on an offer, the offer's page is displayed. The page contains:

   • Banner image (size 1080x574px).

   • Short name of the product (including retailer name).

   • Full name of the product (explanation of a loyalty program or bonus program related to the card).

   • Product logo (round or square).

   • Cost of the product issue (amount in rubles), if the issue is not free.

   • Description of the offer.

3. When the user taps on Issue, the issuing scenario begins.