Payment Platform

Last updated
Save as PDF

Enable integration with Flywire’s Comprehensive Receivables Solution, Paysafe (Canada only), WPM Education (UK only), or Worldline's Online Payment Platform (UK and EU only) to offer a safe and secure payment experience for library users in My Account.

WMS integrates with the payment processors to offer a safe and secure payment experience for library users in My Account.

Caution: A one-time implementation fee is required to enable online payments. Your library or institution will also need an active account with Flywire (Comprehensive Receivables Solution only), Paysafe, or WPM Education. Contact OCLC Library Services or your OCLC Library Services Consultant to learn more.

To access this screen, sign into Service Configuration, open the Third-Party Integrations left navigation, and select Payment Platforms.

Note: Either the Payments Admin or Payments Manager role is required for staff to access the Payment Platform page. Refer to Circulation roles for more information.

To configure your online payment experience:

Select the payment platform for your library users to pay fees. Options include:
- Paysafe
- WPM
- Flywire
- Worldline
Determine whether to Enable for library staff only. When enabled, only staff users with a Payments role may attempt online payments in My Account. Never disable when using a test environment. Refer to Circulation roles for more information.
Enter the settings per payment platform. Setting explanations are below:
Click Save.

Refer to Access and customize My Account and My Account, Fees for more information.

Paysafe Settings

Find the settings related to Paysafe.

Setting	Option	Description
Email address to send errors to	N/A	Address of a library staff member or group email address that should receive a notification from WMS if a patron’s payment fails to reconcile with WorldShare Circulation.
Email address to send outgoing emails from	N/A	Address that users will see as the sender of payment confirmation and error notifications from WMS. Library users may reply to this email address if they have questions about their payment.
Paysafe environment	Test	Payments made via My Account will be submitted to Paysafe’s test server. Caution: Do not select the test environment if Paysafe is enabled for all users, especially if your library is already live with WMS. Before selecting the test server, be sure that the Enable for library staff only setting is enabled. Paysafe’s test environment allows your library staff to use test cards to simulate payment scenarios, CVV responses, and AVS responses. Contact OCLC Support if you would like assistance testing against Paysafe’s test server. Refer to Paysafe documentation for additional information. Caution: Do not submit real card information to the test server.
Paysafe environment	Live	Payments made via My Account will be submitted to Paysafe’s live server for processing against the card issuer.
Paysafe Server-to-Server API key username		All API usernames and passwords are provided by Paysafe and may differ between Paysafe’s test and live servers. Contact Paysafe for more details.
Paysafe Server-to-Server API key password		All API usernames and passwords are provided by Paysafe and may differ between Paysafe’s test and live servers. Contact Paysafe for more details.
Paysafe Single-Use Token API key username		All API usernames and passwords are provided by Paysafe and may differ between Paysafe’s test and live servers. Contact Paysafe for more details.
Paysafe Single-Use Token API key password		All API usernames and passwords are provided by Paysafe and may differ between Paysafe’s test and live servers. Contact Paysafe for more details.
Paysafe account number		Your account number with Paysafe. Contact Paysafe for more details.
Currency supported	CAD USD	Select your institution's currency.
3-D Secure Version	None	Disables 3-D Secure payment authorization. Before selecting this option, OCLC suggests that you discuss the consequences with Paysafe and seek legal advice as needed, especially if you will also disable the Address Verification Service (AVS). Responsibility for fraudulent or unauthorized transactions may shift to your institution when security features are disabled.
	v1	Recommended for institutions in North America. When enabled, the user making a payment may be redirected to the card issuer’s website to authorize the transaction.
	v2	Recommended for institutions in the European Union. When enabled, the user making a payment may be redirected to the card issuer’s website to authorize the transaction.
Address verification level	None	WMS will attempt to settle a payment even if the AVS response from Paysafe indicates an invalid billing address has been provided. Allows payments by card issuers that do not support AVS or do not have a billing address on record. Before selecting this option, OCLC suggests that you discuss the consequences with Paysafe and seek legal advice as needed, especially if you will also disable 3-D Secure (3-DS). Responsibility for fraudulent or unauthorized transactions may shift to your institution when security features are disabled.
	Partial	The AVS check must confirm that the number in either of the street address fields or the postal code in the billing address matched completely before WMS will attempt to settle the payment.
	Full	Recommended. The AVS check must confirm that the numbers in the billing street address fields and postal code in the billing address have matched completely before WMS will attempt to settle the payment.
Fee payment call-to-action text	Pay Pay Fees Pay Fines Pay Now Pay Online Pay With Paysafe	Controls the text of the payment buttons in My Account. The button text will translate automatically based on the user’s selected language.

WPM Settings

Find the settings related to WPM.

Client identifier supplied by WPM
Payment pathway identifier supplied by WPM
Department identifier for the customer supplied by WPM
Email address to send outgoing emails from
- Address that users will see as the sender of payment confirmation and error notifications from WMS. Library users may reply to this email address if they have questions about their payment.
URL for the WPM API to initiate payments
Shared secret used to sign WPM transactions
Fee payment call-to-action text
- Controls the text of the payment buttons in My Account. The button text will translate automatically based on the user’s selected language. Options include:
  - Pay
  - Pay Fees
  - Pay Fines
  - Pay Now
  - Pay Online
  - Pay With WPM

Note: Include the Accounting Code in the Bill Reasons module of the OCLC Service Configuration. Confirm the information contained in this field matches the code used in WPM. Refer to Bill Reasons for more information.

Flywire Settings

Find the settings related to Flywire.

Setting	Option	Description
Environment	Demo	Payments initiated via My Account will be transferred to Flywire's test/mock server for processing. Flywire's demo environment allows your library staff to simulate payment scenarios, including successful and declined payments. Caution: Do not select the demo environment if Flywire is enabled for all users, especially if your library is already live with WMS. Before selecting the demo environment, be sure that the Enable for library staff only setting is turned on.
Environment	Production	Payments initiated via My Account will be transferred to Flywire's live system for processing. Select Flywire's production environment when you are ready to process real payments against user accounts.
Recipient supplied by Flywire		Your recipient ID provided by Flywire. Contact Flywire for more details.
Provider supplied by Flywire		Your provider ID provided by Flywire. Contact Flywire for more details.
Payment destination supplied by Flywire		Your payment destination provided by Flywire. Contact Flywire for more details.
Email address to send outgoing emails from		Address that users will see as the sender of payment reconciliation error notifications sent by WMS. Library users may reply to this email address if they have questions about their payment.
Shared secret used to sign Flywire transactions		Your shared secret provided by Flywire. Contact Flywire for more details.
Fee payment call-to-action text	Pay Pay Fees Pay Fines Pay Now Pay Online Pay With Flywire	Controls the text of the payment buttons in My Account. The button text will translate automatically based on the user’s selected language.
Return to account text	Back to account Return to account	Controls the text displayed in Flywire's payment confirmation screen for the link that will return the user to WMS My Account. The text will translate automatically based on the user's selected language in My Account.

WMS integration in Flywire

Find information about integrating WMS within Flywire.

To integrate with WMS, your institution must use Flywire's Comprehensive Receivables Solution (CRS).
The Flywire Payments API v.2 must be enabled for your Flywire account.
The toCurrency must be configured to match the currency you have configured in the WorldCat Registry. Refer to Currency and Locale for more information.
- Flywire can accept payments in multiple currencies but must always confirm payment in the currency defined by WMS for the original bill(s). Currency mismatches will result in payments failing to reconcile in WMS and the bill will not be marked as paid in WorldShare Circulation after a successful Flywire payment.
Add three custom fields to your Flywire portal:
- oclc_locale: Indicates which language WMS will use to send any reconciliation failure emails to the user. Value depends on the user's selected language in My Account when consenting to payment processing.
- oclc_transaction: Encrypted field for billing information required to reconcile payments with WMS.
- student_email: Used by WMS to send any reconciliation failure emails to the user.
The payment amount must be read-only in Flywire's payment form, meaning the user should not be allowed to change the amount after their data is transferred to the Flywire website.
- WMS will fail to reconcile partial payments and overpayments.
The minimum Flywire payment amount must reflect the smallest bill that your library may create on a patron account.
- Caution: Payments will fail to reconcile in WMS if the user attempts to pay a total amount due in WMS that is less than the minimum configured for Flywire. Flywire's payment form will force the user to enter an amount greater than or equal to the Flywire minimum amount; after payment is taken by the processor, WMS will fail to reconcile the overpayment.

Worldline Settings

Find the settings related to Worldline's Online Payment Platform.

Caution: Do not select Worldline's test environment if Worldline is enabled for all users, especially if your library is already live with WMS. Before selecting the test environment, be sure that the Enable for library staff only setting is turned on.

Setting	Option	Description
Environment	Test	Payments made via My Account will be submitted to Worldline’s test server. Caution: Do not select the test environment if Worldline is enabled for all users. Before selecting the test server, be sure that the Enable for library staff only setting is enabled. Worldline’s test environment allows your library staff to use test cards to simulate payment scenarios. Contact OCLC Support for assistance testing against Worldline's test server. Refer to Worldline's documentation for additional information. Caution: Do not submit real card or banking information to the test server.
Environment	Production	Payments made via My Account will be submitted to Worldline’s live server for processing against the card issuer.
Email address to send transactions to	N/A	Address of a library staff member or group email address that should receive a notification from WMS if a patron’s payment fails to reconcile with WorldShare Circulation.
Email address to send outgoing emails from	N/A	Address that users will see as the sender of payment confirmation and error notifications from WMS. Library users may reply to this email address if they have questions about their payment.
Merchant ID	N/A	Your account number with Worldline Contact Worldline for more details.
Worldline API key ID	N/A	All API usernames and passwords are provided by Worldline and may differ between Worldline’s test and live servers. Contact Worldline for more details.
Worldline API key secret	N/A	All API usernames and passwords are provided by Worldline and may differ between Worldline’s test and live servers. Contact Worldline for more details.
Worldline webhook key ID	N/A	All API usernames and passwords are provided by Worldline and may differ between Worldline’s test and live servers. Contact Worldline for more details.
Worldline webhook key secret	N/A	All API usernames and passwords are provided by Worldline and may differ between Worldline’s test and live servers. Contact Worldline for more details.
Fee payment call-to-action text	Pay Pay Fees Pay Fines Pay Now Pay Online Pay With Worldline	Controls the text of the payment buttons in My Account. The button text will translate automatically based on the user’s selected language.