Integration of YSoft Payment System with YSoft SafeQ

Integration of YSoft Payment System with YSoft SafeQ provides you with ability to charge end users for operations such as print, copy and scan.

 

Connecting YSoft SafeQ 5 with YSoft Payment System

1

Install YSoft SafeQ 5 and YSoft Payment System. For more info see: Installing YSoft Payment System and Installing YSoft SafeQ CML

images/s/-3eliqb/8502/404359a7d2ab19c9c7c58d12013124a386b28257/_/images/icons/emoticons/lightbulb_on.svg NOTE: For proper integration of YSoft SafeQ with YSoft Payment System, sufficient license have to be used in YSoft SafeQ.

2

images/download/attachments/43614327/image2014-10-30_9_48_14.png

Login SafeQ web interface and go to System Settings > YSoft Payment System.

Setup following properties:

  • enablePaymentSystem = Enabled

  • paymentSystemApiUrl = IP address of YSoft Payment Server (Example: https://10.0.11.52:8443)

images/s/-3eliqb/8502/404359a7d2ab19c9c7c58d12013124a386b28257/_/images/icons/emoticons/warning.svg WARNING: Do not use localhost or 127.0.0.1 for paymentSystemApiUrl in multi-server installations of the YSoft SafeQ (multiple CML nodes or ORSs).

 

Click Save changes and restart services as required when saving new settings.

3

YSoft SafeQ 5 and YSoft Payment System should be now connected.

For verification you can:

  1. Login SafeQ web interface and go to Web interface - Payments tab. If tab is correctly displayed and you are able to create new money account or periodic recharge, both systems are fully integrated.

  2. Login Administration web interface and go to Licence tab. If you can see text "YSoft Payment System is fully activated", both systems are fully integrated.

Configure administrators and cash desk operators

To access YSoft Payment System web interfaces, users with proper rights have to be created in YSoft SafeQ. Follow these steps to setup access rights for YSoft Payment System:

  1. Log in to YSoft SafeQ web interface and navigate to Users tab

  2. Create new users or edit existing ones (Web Interface - Users)

  3. Open users details and display Roles tab

  4. Click Add role and add following roles:

images/download/attachments/43614327/image2014-10-30_12_47_10.png

Manage money accounts and periodic recharges

Money accounts and periodic recharges can be maintained by:

Select currency

Currency settings for YSoft Payment System are inherited from YSoft SafeQ, without need of additional steps like restarting services etc.

To setup currency in YSoft SafeQ go to System settings > Regional settings and setup necessary properties, or edit all settings using Welcome to SafeQ widget on SafeQ Dashboard (Widgets - Welcome to YSoft SafeQ ).

Limitations

  • YSoft SafeQ requires numeric GUIDs for accounts in YSoft Payment System, while YSoft Payment System supports alphanumeric format. Accounts with alphanumeric GUIDs cannot be managed using YSoft SafeQ web interface.
    Due to this limitation it is highly recommended to create YSoft Payment System accounts only via YSoft SafeQ web interface.