MDES administration panel

The MDES Administration Panel (or the admin portal/portal for short) is the essential tool for you to work with your online application. Here you can manage customers, their cards, IBANs, devices and track history of payments. The presented solution is prepared for rebranding for the client's brand. The document is divided into sections that describe the various components of the system. Each section contains a screen presenting the functionality and a detailed description of the states occurring in it.


Purpose and scope

This product guide provides a high-level overview of Admin Panel Management. This document covers the following topics:

  • description of the all aggregates of customer, including detailed information and possible actions,

  • description of possible configurations,

  • granting access,

  • description of main processes as: login, reset password

  • additional and optional functionalities.

Abbreviations & Acronyms

This section explains a number of key terms and concepts used in this document.

Name

Description
VPN

Virtual Private Network

MPA

Mobile Payment Application

IBAN

International Bank Account Number

MCBP

Mastercard Cloud Base Payment

MDES

Mastercard Digital Enablement Services

LCAPI

Lifecycle API


Terminology

This section explains a number of key terms and concepts used in this document.

Name

Description
Customer

Customer who uses MPA

User

User using the Admin Panel

Card

Section contains information about customer PANs – physical cards added by customer manually in MPA or bank using LC API

IBAN

Customer bank account number. MCBP enables bank account numbers to be digitized and used for payments

Token

Payment Token in context of MCBP. Tokens are result of correct digitization. Each token has one wallet account, one card/IBAN number and one device related

Device

Device is data aggregate related to customer. Device is entity in MDES – created during MDES registration. Each registration of customer has device on Verestro side, but each customer may have multiple MDES registrations

Payment history

It’s possible that transaction history will be stored on Verestro wallet server for infinite time (this setting can be specified during onboarding with Mastercard). If these options are enabled, MPA can retrieve transaction history for given user and payment instrument ID. Transactions are returned in corresponding parts for better user experience. Particular transaction may appear on the list with delay – depending on integrated external components

LCAPI

API Used for direct integration to partner. Allows to manage users, cards, etc

Session token

Access to the system by a web application user is secured using a session token to uniquely associate the session with the user. It is required to perform any action

MAIN VIEW

Once the authentication process is properly completed, the bank employee has access to the panel. He is shown the main screen of the system. Depending on the assigned rights group its appearance may vary. Different roles in the system have different tabs available. 

image-1651662664655.png

The components that make up the Admin Portal are:
1) Main menu contains aggregates as: customers, cards, devices, payment history, IBANs, project administration (administrators, visuals, logs),
2) Admin Panel adjusted to the client’s colours and logotype. 
3) Filters allows to select multiple filter options and display results that contain information all the selected criteria. 
4) List of the most important information referring to each aggregate (example: customers).  
5) Actions allows admin to change the status of aggregate or edit data.  

CUSTOMERS MANAGEMENT

Customers list

Customer list contains filters and columns with dates. The filters are used for dynamic searching, such data as:  customer ID, external ID, e-mail, phone number, status (unverified, verified, locked, deleted). 

image-1651662700924.png

Basic list includes following information:

Parameter

Description

Customer ID

internal Verestro Id of customer

External ID

external customer identifier provided by client (for example: recordID)

E-mail

customer e-mail address

Phone number

customer phone number with country prefix

First name

customer first name

Last name

customer last name

Status

customer status (described in customer statuses part)

Action

action which can be performed on particular customer (described in customer actions part)

Customers details

Selecting a specific user allows to see more detailed data. In addition to personal information, a list of related devices, IBANs, tokens, and payment history is available. 

image-1651662763555.png

Detailed list includes following information:

Parameter

Description

Customer ID

internal Verestro Id of customer

External ID

external customer identifier provided by client (for example: record ID)

First name

customer first name

Last name

customer last name

Phone number

customer phone number with country prefix

E-mail

customer e-mail address

Status

customer status

Number of failed logins

number of login failures

Created at

date of customer registration

Deleted at

date of customer deletion (parameter displayed only if customer has been removed from system)


Additionally, in details are available lists of aggregates related to the particular customer:
•    customer devices (more information in devices management),
•    customer IBANs (more information in IBANs management),
•    customer cards (more information in cards management),
•    customer tokens (more information in tokens management),
•    payment history (more information in payment history). 

Customer statuses

A user can be defined by one of four statuses. The system created by Verestro divides the statuses into the following: 

image-1651662842347.png

Customer actions

Admin can perform the following actions on the particular customer:
a)    view customer – redirect to the screen with customer details data,
b)    edit customer – redirect to the screen with edition (screen below). The following data can be edited:
•    first name, 
•    last name, 
•    phone number, 
•    e-mail,

image-1651662880039.png

c)    lock customer – temporary lock of customer (more information in customer statuses part),
d)    delete customer – permanent delete customer data (more information in customer statuses part).

The following table shows the states of the user's token after performing each action.

Action

Token status

Add customer

Unverified

User authentication

Verified

Lock customer

Locked

Unlock customer

Verified

Delete customer

Deleted

Referring to the above table, a diagram has been created showing the change of states of the user token. This allows for better visualization of actions and dependencies between them.

2023-03-09_14h48_28.png

CARDS MANAGEMENT

Cards list

Cards list contains filters and columns with dates. The filters are used for dynamic searching, such data as:  card ID, last 4 digits, date of creation, status (available: unverified, verified, locked, deleted). 

image-1651664519865.png

Basic list includes following information:

Parameter

Description

Card ID

internal Verestro Id of card

Customer ID

internal Verestro Id of customer

Last 4 digits

last four digits of physical PAN

Exp date

expiration date in MM/YY format

Type

card type (Mastercard, Visa)

Status

card status (described in card statuses part)

Action

action which can be performed on particular card (described in card actions part)

Card details

Selecting a specific card allows to see more detailed data. In addition to basic information, a list of related customers, and payment history is available.  

image-1651664549139.png

Detailed list includes following information:

Parameter

Description

Card ID

internal Verestro Id of card

Last 4 digits

last four digits of physical PAN

Expire date

expiration date in MM/YY format

Description

friendly name of card

Type

card type (Mastercard, Visa)

Status

card status. Available: verified, unverified, deleted, locked.

Created at

date of card addition to the wallet database

Deleted at

date of card deletion from the wallet database

Additionally, in details are available aggregates related to the particular card:
•    customers (more information in customers management),
•    customer tokens (more information in tokens management),
•    payment history (more information in payment history).

Card statuses

A customer can be defined by one of four statuses. The system created by Verestro divides the statuses into the following: 

image-1651664590912.png

Card actions

Admin can perform the following actions on the particular card:
a)    view card – redirect to the screen with card details data,
b)    lock card – temporary lock of card (more information in card statuses part)
c)    delete card – permanent delete card data (more information in card statuses part).

Below table presents how action may change the statuses of card

Action

Statuses


 

Card’s status

Token’s status

Add card

Unverified


Verify card

Verified


Lock card

Locked

Suspended

Unlock card

Verified

Active

Delete card

Deleted

Deleted

Referring to the above table, a diagram has been created showing the change of states of the card. This allows for better visualization of actions and dependencies between them.

2023-03-09_14h42_42.png

IBANS MANAGEMENT

IBANs list

IBANs list contains filters and columns with dates. The filters are used for dynamic searching, such data as:  IBAN ID, IBAN number, status (active, deleted).