Configure PayPal to process fines and fees

You can configure Vega to use PayPal Payflow Pro for fine payments. If you previously used PayPal Payflow Link or if you have an older PayPal Payflow Pro account, you need to update to a newer version of Payflow Pro to accept fine payments with Vega.

Innovative highly recommends that you set up a new PayPal account to use with Vega. Because PayPal accounts can only be configured for one website at a time, you can’t use the PayPal account that you used for your previous discovery system. After you complete the migration from your previous discovery system to Vega Discover, you can cancel your previous PayPal account.

You must set up a PayPal user before you configure Vega to work with PayPal. The user's role should be set to API_LIMITED_TRANSACTIONS. This enables the user to perform transactions with Vega, but the user cannot log in to PayPal Manager.

Do not use your Vega administration credentials for this purpose.

Important

  • You must select a currency on the Localization settings configuration page for this feature to work. For more information, see Configure localization settings.

To set up electronic payment of fines and fees, perform the following tasks:

  1. Set up a PayPal user account that is authorized to perform transactions with Vega.
  2. Set up PayPal to process patron payments from Vega.
  3. Select a payment form layout.
  4. Configure Vega to work with PayPal.

About collection site-level payment configuration

If your library uses a single payment account across all branches or collection sites for processing patron fine payments, you should configure fine payment at the Vega Discover level. If any branches or collection sites use a separate payment account for processing patron fine payments, you can configure that fine payment account at the consortia collection site- or kiosk-level.

If there is no consortia collection site- or kiosk-level fine payment configuration, the collection sites or kiosks use the Vega Discover-level fine payment account.

  1. Go to https://manager.paypal.com, and log in to your PayPal Manager account.
  2. In PayPal Manager, select the Account Administration tab.
  3. On the Manage Users tab, select Add User.
  4. In the Admin Confirmation section, do the following:
  • In the Admin Confirmation Password field, enter your password.
  1. In the User Information section, enter the following information:
  • Contact name
  • (Optional) Phone number
  • Email address
  1. In the User Login Information section, do the following:
  1. In the User Login Name field, enter the username.

    2. The username must match the name that you specify when you configure PayPal in Vega.

    Innovative suggests a username that identifies the purpose of the user such as "vega" or "vegapayments".

  2. In the User Password field, enter a password.

    3. The password must contain only alphanumeric characters and it must match the password you specify when you configure PayPal in Vega.

    Note: Don't use special characters in the user password. If you use special characters, it will cause an error when you try to make payments from Vega.

  3. In the Confirm User Password field, enter the password again.
  1. In the Assign Privilege to User section, do the following:
  1. In the Select a Predefined Role field, select API_LIMITED_TRANSACTIONS.
  2. In the User Status field, select Active.
  1. Select Update.
  1. In PayPal Manager, select the Service Settings tab.
  2. In the Hosted Checkout Pages section, select Set Up.
  3. On the Set Up page, in the Display options on payment page section, do the following:
  1. In the Choose your settings section, from the Transaction Process Mode list, select Live.
  2. In the Display options on payment page section, from the Show PayPal Logo list, select Yes if you want to include the PayPal logo on the payment page.
  3. (Optional) In the Enter Text for Cancel URL field, enter the text you want to appear on the cancel button on your site.
  4. In the Enter Cancel URL field, enter the following:

    5. https://<vega_home_url>/user/fines-and-fees

    Examples of Vega home URLs:

    • mylibrary.na.iiivega.com
    • mylibrary.na2.iiivega.com
    • mylibrary.na4.iiivega.com

    Example of a cancel URL:

    • https://patron.experience.iiivega.com/user/fines-and-fees

    Patrons are redirected to this page when they cancel a payment.

    Important:

    • If your library uses a custom domain, enter the custom domain URL.
  5. In the Enter Error URL field, enter the following:

    6. https://<vega_home_url>/api/personalization/payments/v1/paypal/status/error

    Patrons are redirected to this page if an error occurs.

    Important:

    • If your library uses a custom domain, enter the custom domain URL.
  6. From the Cancel URL Method list, select GET.
  7. In the Enter Button Text field, enter the text that you want to appear on the payment button on your site.
  1. In the Billing Information section, select the fields that you want patrons to complete when they make a payment.

    2. For all fields that you select as required, you must also select them as editable. Otherwise, patrons can't enter their information.

    Innovative recommends that you select the following:

    • Name
    • Phone
    • Email Address
    • CSC
    • ZIP code/Postal code
  2. In the Payment Confirmation section, do the following:
  1. For Show confirmation page, select On my website.
  2. In the Enter Return URL field, enter the following:

    3. https://<vega_home_url>/api/personalization/payments/v1/paypal/status/success

    Important:

    • If your library uses a custom domain, enter the custom domain URL.
  3. From the Return URL Method list, select GET.
  1. In the Silent Post for Data Transfer section, do the following:
  1. From the Use Silent Post list, select Yes.
  2. In the Enter Silent Post URL field, enter the following:

    3. https://<vega_home_url>/api/personalization/payments/v1/paypal/callback?iii_customer_domain=<vega_home_url>

    Important:

    • If your library uses a custom domain, enter your original Vega URL and not your custom domain, or else payments won’t process.
  3. Select Void transaction when my server fails to receive data sent by the silent post.
  4. In the Return URL when Silent Post fails field, enter the following:

    5. https://<vega_home_url>/api/personalization/payments/v1/paypal/status/error

    Important:

    • If your library uses a custom domain, enter your custom domain URL.

  1. If you require patrons to enter their email address to complete a payment and you want to send a payment confirmation, complete the Email Confirmation section.
  2. In the Security Options section, from the Enable Secure Token list, select No.

    3. Vega Discover doesn’t support secure tokens at this time.

  3. Select Save Changes.
  1. On the Service Settings tab, select Customize.
  2. Select one of the following layouts:
  • Layout A
  • Layout B
  1. To preview your layout, select Preview.
  2. Select Save and Publish.
  1. Go to Settings > Localization settings > Configuration.
  2. On the Localization settings configuration page, select Override currency display.
  3. Select the currency that PayPal will use.

    4. Repeat this step for all currencies, including US currency.