How to set up a Payment Gateway in PaperCut NG and MF

Independent Application Servers
(different CRNs)

Yes. Each Application Server / CRN needs its own separate Payment Gateway entitlement.

Multiple Application Servers
(same CRN)

No. They share the single Payment Gateway entitlement pool attached to that CRN.

2 Independent App Servers

2 CRNs

2 Add-ons (1 per CRN)

Each CRN gets its own distinct Gateway license/subscription.

2 App Servers under 1 CRN

1 CRN

2 Add-ons (under the same CRN)

3 September 2026

26.0.2076

Cybersource Payment Gateway: Added support for Cybersource Unified Checkout Payment Gateway. This updates the integration ahead of Cybersource's End-of-Life (EOL) for the Secure Acceptance interface on September 30, 2026, ensuring uninterrupted payment processing. For details, see the Payment Gateway Module release notes. [PO-4112]

Fixed an issue with payment gateways to improve security by hardening the "Add Credit" and administration interfaces across all payment gateway integrations against potential Cross-Site Scripting (XSS) vulnerabilities. [PO-3920]

[PO-4112]

[PO-3920]

30 June 2026

25.0.2063

Fixed an issue with the TouchNet OneCard integration that intermittently prevented user balances from being correctly retrieved and displayed on the user interface. [PO-4327]

Fixed an issue where TouchNet OneCard debit transactions would fail. This occurred because a newly added transaction field OneCardTransGUID was added. [PO-4404]

[PO-4327]

[PO-4404]

05 May 2026

25.0.2032

Upgraded the CommWeb (Commonwealth Bank) integration to the latest API standards (v100+). [PO-4176]

[PO-4176]

10 April 2026

25.0.2025

Fixed an issue with the CommWeb payment gateway where a synchronization error could cause the payment page to initialize incorrectly. [PO-4180]

Fixed an issue where CommWeb transactions failed for users with long usernames (such as Microsoft Entra ID UPNs). The payment gateway now ensures the Order ID remains within the maximum 34-character limit while maintaining a unique identifier. [PO-4093]

[PO-4180]

[PO-4093]

10 Feb 2026

25.0.2014

Fixed an issue in the Application logs where an error 'Network Payment API not enabled' was incorrectly recorded. [PO-2482]

Fixed an issue where the Add Credit page was missing for TouchNet users after upgrading to v25.0. [PO-3795]

[PO-2482]

[PO-3795]

12 Aug 2025

25.0.325

Introduced a new version of the payment gateway module based on the new PaperCut NG/MF application server version 25.0 due to incompatibility issues. This version is only compatible with PaperCut NG/MF version 25 and later.

[PO-3404]

19 Jan 2024

23.0.271

Fixed an issue with CBORD Payment Gateway where extraneous data was being prefixed to XML responses. [PO-1612]

Security enhancement to ensure that all password fields within the configuration files; server.properties and any payment gateway configuration files, are encrypted. [PO-1130]

[PO-1612]

[PO-1130]

19 Jan 2023

22.0.248

Fixed an error that showed an error page on devices when trying to top up an account on demand. Fixed an error in the Official payment gateway. Fixed an error that canceled payments from Paypal. Removed personal identifiable information from the logs.

[PO-1026]

[PC-18912]

[PO-1058]

[PO-1166]

26 Sep 2022

22.0.236

Fixed an error in the Moneris Checkout for Papercut MF/NG versions 19.x and 20.x. For Realex gateway use their hosted page for billing info validation.

[PO-1047]

[PO-543]

08 Sep 2022

22.0.230

Fixed a typo in the Moneris Checkout configuration file.

[PO-1025]

31 Aug 2022

22.0.229

Realex Payment Gateway 3D Secure - We’ve added a new form to the Realex Payment Gateway to comply with new Strong Customer Authentication (SCA) regulations in the European Union. Added the Moneris Checkout payment gateway.

[PO-59]

[PO-938]

27 Jan 2022

21.2.219

Updated to remove log4j from the Payment Gateway module install. The payment gateway will use whatever version is installed as part of the App Server installation.

[PO-749]

20 Dec 2021

21.2.214

Updated with log4j version 2.17.

[PO-698]

17 Dec 2021

21.2.213

Updated with log4j version 2.16.

[PO-697]

10 Nov 2021

21.2.210

Fixed

keyword when writing to the user’s transaction log. Corrected log levels (previously all messages output as error).

[PO-439]

[PO-515]

4 Nov 2021

21.2.207

Updated Network API Payment Gateway to not log errors on receiving a 404 response from the remote server.

Note: Module starts including log4j*jar files in the build (not used actively)

[PO-552]

14 Oct 2021

21.1.202

Made Network Payment Gateway balance check more tolerant of integer balance values.

[PO-377]

14 May 2021

21.0.185

Improvements to the handling of the HPP_KEY when using the Moneris payment gateway.

[PO-240]

20 Nov 2019

20.0.150

Functionality added for developers who need to provide a custom job payment integration.

[PC-15212]