Payment gateway plugin deployment


This page describes how to use the interactive installer to perform payment gateway plugins installation, which are additional components for YSoft SafeQ Payment System. We use installation of PayPal plugin as an example. DIBS plugin installation is very similar, main difference is in its configuration (step 6).

Payment System supports two main plugin installers and many more can be ordered as an extension. For more detail about connection of payment gateways to payment system, see YSoft Payment System Administration web interface.

New installation or update of payment gateway plugins for PayPal and DIBS

  1. Run the installation file on the target computer. This usually means YSoft SafeQ Payment System server, but in general payment gateway plugins can be installed on any server. Plugin installers are named as following:

    • ysf-ps-paypal.exe for PayPal payment plugin

    • ysf-ps-dibs.exe for DIBS payment plugin

  2. Select a language that will be used for the installation process.

    images/download/thumbnails/160480815/image2016-6-7_16_4_15.png
  3. It is recommended to close all other running applications in order to avoid any issues during the installation. Click Next to proceed through welcome screen.

    images/download/attachments/160480815/image2016-6-7_16_3_43.png
  4. Click I Agree to accept the license agreement. Clicking on Cancel will decline the license agreement and stop the installation.

    images/download/attachments/160480815/image2016-6-7_16_1_30.png
  5. Installer now runs a pre-installation check, to ensure YSoft SafeQ Payment System is installed on the local computer. If any previous version of payment gateways plugin has been installed on the local computer, this plugin will be updated.

    images/download/attachments/160480815/image2016-6-7_16_15_58.png
  6. Fill in required settings for connection to payment gateway according payment gateway provider.

    PayPal API Endpoint URL

    Use PayPal's service URL (usually https://api.paypal.com/).

    PayPal API Client ID (hash)

    Hashed username of your PayPal signature.

    PayPal API Secret (hash)

    Hashed password of your PayPal signature.

    DIBS Username

    Username of DIBS merchant's account.

    DIBS Password

    Password of DIBS merchant's account.

    DIBS MD5 Key 1

    Merchant key for payments

    DIBS MD5 Key 2

    Merchant key for payments

    DIBS Merchant ID

    ID of merchant's account

    Allowed Cards

    Card, that will be accepted by the DIBS gateway. See link http://tech.dibspayment.com/toolbox/paytypes for possible values

    Information about PayPal signature should be available on your PayPal business account profile. For more detail about obtention of PayPal signature, see Creation of PayPal API signature.

    PayPal credentials (=hashed values) can be found in https://developer.paypal.com/developer/applications > REST API apps > click desired app > "Client ID" / "Client Secret".

    images/download/attachments/160480815/image2018-11-16_15-45-56.png

    Below are examples of PayPal and DIBS configuration.

    images/download/attachments/160480815/image2016-6-7_16_21_41.png

    images/download/attachments/160480815/image2016-6-7_16_30_35.png

  7. The installer begins to copy all the required files into destination folder defined by the location of the payment system on the local machine. In case you wish to see detailed installation progress, press Show details button (or D key).

    images/download/attachments/160480815/image2016-6-7_16_40_6.png
  8. Once installation is complete, click Finish when you are ready to close the installation wizard. Installation is now complete and you can continue by connecting payment system to installed payment gateway plugin by following chapter YSoft Payment System Administration web interface.

    images/download/attachments/160480815/image2016-6-7_16_40_54.png

Connecting YSoft SafeQ Payment System to payment gateway plugin

  1. Login into YSoft SafeQ Payment System Administration web interface.

  2. In menu Payment gateways click Create connection to plug-in and fill according to description of attributes in YSoft Payment System Administration web interface, section Payment Gateways. Use related URL for PayPal or DIBS.

  3. Save the connection by clicking on Connect button.