Skip to main content
ExLibris
  • Subscribe by RSS
  • Ex Libris Knowledge Center

    Configuring the Pay Fine Link for Alma-Summon

    Return to menu

    The Library Card Links mapping table allows you to integrate a payment system other than WPM E-Payment whose integration is built into Alma. When enabled, a Pay Fine link displays on both the Overview and Fine and Fees tabs in My Library Card. For more information on the WPM system, see Configuring the WPM Education E-Payment System for Alma-Summon.

    PVE_MyLibraryCard_PayFineLink.png

    My Library Card - Fine + Fees Tab

    When users select the Pay Fine link, Alma passes the user information in an encoded JWT (JSON Web Token) to your Web Service (as indicated by the online_payment_url) in a new browser tab. This JWT, which contains the user_id and other relevant parameters, can be used to invoke the Alma Rest APIs.

    The decoded User JWT includes the following information:

    "iss": "soa",

    "jti": "A2FAD2A1CA5402A6E14C5A274383EE34.apd02.na02.prod.alma.dc04.hosted.exlibrisgroup.com:1801",

    "exp": 1557206531,

    "iat": 1557120131,

    "userName": "jsmith",

    "displayName": "John",

    "user": "4518625460000121",

    "userGroup": "",

    "institution": "MYDEV1_INST",

    "userIp": "222.222.22.22",

    "authenticationProfile": "Alma",

    "authenticationSystem": "",

    "language": "es",

    "samlSessionIndex": "",

    "samlNameId": "",

    "onCampus": "true",

    "signedIn": "true",

    "viewId": "MYDEV1_INST:Services"

     
    Example Decoded JWT
     
    To enable the Pay Fine link in My Library Card:
    1. Open the Library Card Links mapping table (Configuration Menu > Discovery > Library Card Configurations > Payment Link Configuration).

      PVE_LCL_PaymentConfig.png

      Library Card Links Mapping Table
    2. Edit the row containing the online_payment_url parameter. Note that you can define this parameter on multiple rows, but only one can be enabled at a time.

    3. In the The URL field, specify the URL used to access your Web service, which integrates Primo VE with the e-payment system.

    4. Set the Use jwt Token field to true if you want Alma to append the encoded JWT token to the URL. Otherwise, set it to false.

    5. Enable the online_payment_url parameter.

    6. Select Save. The first time that you configure the URL, select Customize.

    7. If you want to customize or translate the label for the Pay Fine Link, modify the display label for the fines.payfinelink code in the Library Card Labels code table (Configuration Menu > Discovery > Display Configuration > Labels). For more information, see Configuring the Display Labels for Alma-Summon.

    • Was this article helpful?