# Overview

<span lang="en-US">This document provides high level description of functionalities offered by Donate Widget. Donate Widget supports e-commerce transactions, thus releasing Customer from the need to handle the transaction process on his side – the entire transaction process will be handled by Verestro. The tool is very easy to integrate because it requires to plug one library. The solution can be supported by various Acquirers. Note that if the Customer requires the settlement of the transaction by a new Acquirer – to which Verestro is not integrated – </span><span lang="en-US">there will be required new integration between Verestro and the new Acquirer.</span><span lang="en-US"> The specification of the new Acquirer should be provided </span><span lang="en-US">by the Customer.</span>

## <span lang="en-US">Abbreviations</span>

<span style="font-family: Lato;">Abbreviations and Acronyms used in the document:</span>

<table border="1" cellpadding="1" cellspacing="0" id="bkmrk-abbreviation-descrip" style="border-collapse: collapse; width: 100%; background-color: 1c1e3f; border-color: 1C1E3F;" width="693"><tbody><tr valign="TOP"><td bgcolor="#1C1E3F" style="width: 349.5px;" width="353"><span style="font-family: Lato; color: #ecf0f1;">**Abbreviation**</span>

</td><td bgcolor="#1C1E3F" style="width: 349.5px;" width="353"><span style="font-family: Lato; color: #ecf0f1;">**Description**</span>

</td></tr><tr valign="TOP"><td style="width: 349.5px;" width="353"><span style="font-family: Lato;">ACQ</span>

</td><td style="width: 349.5px;" width="353"><span style="font-family: Lato;">Acquiring Institution / Acquirer</span>

</td></tr><tr valign="TOP"><td style="width: 349.5px;" width="353"><span style="font-family: Lato;">ACS</span>

</td><td style="width: 349.5px;" width="353"><span style="font-family: Lato;">Access Control Server</span>

</td></tr><tr valign="TOP"><td style="width: 349.5px;" width="353"><span style="font-family: Lato;">SDK</span>

</td><td style="width: 349.5px;" width="353"><span style="font-family: Lato;">Software Development Kit</span>

</td></tr><tr valign="TOP"><td style="width: 349.5px;" width="353"><span style="font-family: Lato;">Mid</span>

</td><td style="width: 349.5px;" width="353"><span style="font-family: Lato;">Merchant Identifier</span>

</td></tr><tr valign="TOP"><td style="width: 349.5px;" width="353"><span style="font-family: Lato;">PCI DSS</span>

</td><td style="width: 349.5px;" width="353"><span style="font-family: Lato;">Payment Card Industry Data Security Standard</span>

</td></tr><tr valign="TOP"><td style="width: 349.5px;" width="353"><span style="font-family: Lato;">PAN</span>

</td><td style="width: 349.5px;" width="353"><span style="font-family: Lato;">Permanent Account Number</span>

</td></tr><tr valign="TOP"><td style="width: 349.5px;" width="353"><span style="font-family: Lato;">CVC</span>

</td><td style="width: 349.5px;" width="353"><span style="font-family: Lato;">Card Verification Code</span>

</td></tr><tr valign="TOP"><td style="width: 349.5px;" width="353"><span style="font-family: Lato;">3DS</span>

</td><td style="width: 349.5px;" width="353"><span style="font-family: Lato;">3-D Secure</span>

</td></tr></tbody></table>

## Terminology

<span style="font-family: Lato;">This section explains a meaning of key terms and concepts used in this document:</span>

<table border="1" cellpadding="1" cellspacing="0" id="bkmrk-abberations-descript" style="width: 0px;" width="708"><tbody><tr valign="TOP"><td bgcolor="#1C1E3F" style="width: 164px;" width="129"><span style="font-family: Lato; color: #ecf0f1;">**Abberations**</span>

</td><td bgcolor="#1C1E3F" style="width: 538px;" width="573"><span style="font-family: Lato; color: #ecf0f1;">**Description**</span>

</td></tr><tr valign="TOP"><td style="width: 164px;" width="129"><span style="font-family: Lato;">Customer/Merchant</span>

</td><td style="width: 538px;" width="573"><span style="font-family: Lato;">Institution which uses Verestro products. This institution decides which solution should be used depending on the business requirements and how transaction should be processed. </span>

</td></tr><tr valign="TOP"><td style="width: 164px;" width="129"><span style="font-family: Lato;">User</span>

</td><td style="width: 538px;" width="573"><span style="font-family: Lato;">End-User which uses Donate Widget Solution. It is root of entity tree. User is an owner of the card and is an entity that decides to pay for the purchase with the Donate Widget Solution, selecting it from the list of payment methods available on the Merchant (Customer) website.</span>

</td></tr><tr valign="TOP"><td style="width: 164px;" width="129"><span style="font-family: Lato;">Card</span>

</td><td style="width: 538px;" width="573"><span style="font-family: Lato;"><span lang="en-US">Card belongs to the user. If user intends to pay with the Donate Widget Solution, then has to insert required card's data to the appropriate fields shared by the Merchant Paytool solution. Card data will not be stored in the Verestro system. </span>They will be provided to Acquirer.</span>

</td></tr><tr valign="TOP"><td style="width: 164px;" width="129"><span style="font-family: Lato;">Acquirer</span>

</td><td style="width: 538px;" width="573"><span style="font-family: Lato;">External Institution resposible for processing transaction and 3ds requests ordered by the Donate Widget Solution. Acquirer connects with banks / card issuers and returns an information whether the ordered action on a given card is possible.</span>

</td></tr><tr valign="TOP"><td style="width: 164px;" width="129"><span style="font-family: Lato;">MID</span>

</td><td style="width: 538px;" width="573"><span style="font-family: Lato;"><span lang="en-US">Merchant identifier. This entity is represending Merchant in Acquirer's system. Customer has to provide the mid information to enable mid configuration in the Verestro system. </span>Required to process transactions and 3DS via Verestro system.</span>

</td></tr><tr valign="TOP"><td style="width: 164px;" width="129"><span style="font-family: Lato;">API Key</span>

</td><td style="width: 538px;" width="573"><span style="font-family: Lato;">Unique UUID value assigned to the Customer account in Donate Widget Backend. Using this value, the Donate Widget SDK is able to get all configuration data required to perform transaction process via Donate Widget Solution.</span>

</td></tr><tr valign="TOP"><td style="width: 164px;" width="129"><span style="font-family: Lato;">PAN</span>

</td><td style="width: 538px;" width="573"><span style="font-family: Lato;">It is 7-16 digits of the credit/debit card number. These digits contain the Permanent Account Number assigned by the bank to uniquely identify the account holder. It is necessary to provide it when User wants to pay with a card for purchases on the internet.</span>

</td></tr><tr valign="TOP"><td style="width: 164px;" width="129"><span style="font-family: Lato;">CVC</span>

</td><td style="width: 538px;" width="573"><span style="font-family: Lato;">It is a type of security code protecting against fraud in remote payments. Card Verification Code is necessary to provide it when User wants to pay with a card for purchases on the internet.</span>

</td></tr><tr valign="TOP"><td style="width: 164px;" width="129"><span style="font-family: Lato;">Expiration Date</span>

</td><td style="width: 538px;" width="573"><span style="font-family: Lato;">It is a date of the card validity ending and contains two values – month/year. Card will be valid to the last day of the month of the year showed on it. It is necessary to provide it when User wants to pay with a card for purchases on the internet.</span>

</td></tr><tr valign="TOP"><td style="width: 164px;" width="129"><span style="font-family: Lato;">3DS</span>

</td><td style="width: 538px;" width="573"><span style="font-family: Lato;">3-D Secure is a method of authorization of transaction made without the physical use of a card, used by payment organization. The 3DS process in the Donate Widget Solution is performed internally in the Verestro system.</span>

</td></tr><tr valign="TOP"><td style="width: 164px;" width="129"><span style="font-family: Lato;">PCI DSS</span>

</td><td style="width: 538px;" width="573"><span style="font-family: Lato;">It is a security standard used in environments where the data of payment cardholders is processed. The standard covers meticulous data processing control and protection of users against violations.</span>

</td></tr></tbody></table>

## <span style="font-family: Lato;">Donate Widget Key Components</span>

<span style="font-family: Lato;">This section provides introduction to technologies which are supported by Donate Widget Solution.</span>

<table border="1" cellpadding="1" cellspacing="0" id="bkmrk-component-descriptio" style="width: 0px;" width="712"><tbody><tr valign="TOP"><td bgcolor="#1C1E3F" width="214"><span style="color: #ffffff;"><span style="font-family: Lato;">**Component**</span></span>

</td><td bgcolor="#1C1E3F" width="492"><span style="color: #ffffff;"><span style="font-family: Lato;">**Description**</span></span>

</td></tr><tr valign="TOP"><td width="214"><span style="font-family: Lato;">Donate Widget Frontend</span>

</td><td width="492"><span style="font-family: Lato;">Component containing the part of the solution which is displayed to the User. Basic information about the transaction shown such as the name of the Merchant (Customer), amount and currency, as well as inputs for card data.</span>

</td></tr><tr valign="TOP"><td width="214"><span style="font-family: Lato;">Donate Widget SDK</span>

</td><td width="492"><span style="font-family: Lato;">Component containing all necessary scripts whether to perform communication between Donate Widget Frontend and Backend and the data exchanging between these two components. Donate Widget SDK should be included on the Customer website.</span>

</td></tr><tr valign="TOP"><td width="214"><span style="font-family: Lato;">Donate Widget Backend</span>

</td><td width="492"><span style="font-family: Lato;">Component stores the configuration data of a given Customer such Merchant Name or Merchant Id and it is responsible for providing all necessary configurations to the Frontend. It also communicating with various Acquirers and triggers notifications to the Customer and the User (depending on the Customer requirements) about successful or unsuccessful transaction.</span>

</td></tr><tr valign="TOP"><td width="214"><span style="font-family: Lato;">Notification Service</span>

</td><td width="492"><span style="font-family: Lato;"><span lang="en-US">Component responsible for sending information to the Customer about the status of the transaction status. It is also responsible for sending email to the User about the transaction. </span>Notification Service is triggered by Donate Widget Backend.</span>

</td></tr></tbody></table>

## Application Demo

The trial version available for viewing and interaction is available <span style="color: #000000;">[<span style="text-decoration: underline;">here</span>](https://rpm-front.upaidtest.pl/donate-ukraine). </span>