Ex Libris-Touchnet Connector

by ExLibrisGroup

GitHub Readme.md

Ex Libris Touchnet Connector

This connector enables libraries from universities that use Touchnet payment services to accept payment of fines and fees. The university can set up a link to the connector in the discovery system. When the patron clicks on the "Pay Fines" link, the conenctor will set up the payment and direct the patron to Touchnet to pay. Successfully completed payments are posted to the patron's account in Alma

Configuring the Connector

In order to use the connector, you need to coordinate with Touchnet customer service. They will provide the following two pieces of information:

  • uPay Site ID, stored in the UPAY_SITE_ID environment variable
  • uPay Site URL, stored in the UPAY_SITE_URL environmente variable

In addition, you'll need an API key for Alma. Instructions for obtaining an API key are available at the Ex Libris Developer Network. The API key should include read/write permissions for "users". The API key is stored in the ALMA_APIKEY environment variable.

Deploying to Heroku

The easiest way to deploy the connector is to use the Heroku platform. Heroku has free plans (which could be appropriate depending on the level of usage) or very reasonable "hobby" plans. To deploy to Heroku, gather the parameters specified above and then click on teh link below to sign up and deploy the connector.


Configuration in Primo

To add the "Pay Fines" link to Primo, follow the instructions in this online help entry. Be sure to include a ? at the end of the URL. For example, if your Heroku URL is https://exl-touchnet-connector-myuni.herokuapps.com, configure the following in Primo: https://exl-touchnet-connector-myuni.herokuapps.com/touchnet?.