In-Store Payments

Documentation v5.3.5

• Added information about Pay Softpos.

Documentation v5.0.0

• Updated command for avoiding privilege elevation.
• Use case for easier configuration of terminal and POS system.
• Update of TransactionSetup and property AcquirerData.

Documentation v4.8.0

• Purchase order number may be included in payment and forwarded to Pospay.
• Updates for the .Net SDK

Documentation v4.7.0

• Manually entered Payment Instrument explained.
• Automatic configuration of terminal address in POS.
• Auto configuration when using .Net SDK.
• Structural changes of documentation for .Net SDK.
• Updates for the .Net SDK

Documentation v4.6.1

• Possibility to send PrintRequest to A920Pro.
• Documentation about fuel functionality.
• Updates for the .Net SDK.

Documentation v4.6.0

• Updated documentation for the .Net SDK and new methods in the interface.
• Added documentation about direct integration and the nexo Retailer interface.

Pax Release 1.3.0.14

PAX-4300: The payment app now sends DisplayRequest and InputRequest immediately after the ECR-on-device app logs in with the correct SaleCapabilities.

PAX-4255: The terminal now supports Omni Non-Payment Token and can request it from PosPay during CardAcquisition, before authorization.

PAX-4229: It is no longer possible to log in and process payments if the POI is missing.

PAX-4228: The terminal switches POI but uses outdated parameters. During the first login attempt, the correct parameters are now retrieved, and the terminal responds with “busy” to new requests from the POS until the new/correct parameters have been applied and the terminal is ready again.

PAX-4159: The terminal no longer sends a status report to TMS during login. However, it still sends status reports in the following cases: at startup, when logging in with a new POI ID, upon manual request, and automatically every hour.

PAX-4202: A920Pro: When processing refunds, it has been unclear who is required to sign the receipt. In Stand-alone mode, the receipt now clearly specifies who must sign it (the customer or the merchant).

Pax Release 1.3.0.13

PAX-4271: Addressed an HTTPS issue related to certificate renewal (reported by Ziklo).

PAX-4258: Optimization: Improved handling of log data when plugin applications (e.g., Fuel) are used.

PAX-4220: Issue resolved: The terminal will no longer enter a loop when the host responds with “Missing PIN” (88) even though the PIN has already been entered. The terminal now prompts the customer to enter the PIN again.

PAX-4203: Enhanced logging: Terminal restarts initiated using the physical power button are now also logged (requested by Coop).

PAX-4224: Issue resolved with application selection (Consumer Choice): The menu can no longer be closed until a selection has been made.

PAX-4292: Issue resolved with application selection (Consumer Choice): The terminal now registers and remembers the customer’s selection and does not allow the card to be changed until the transaction is completed (reported by Reitan DK).

PAX-3567: Improved update logic: The terminal now provides clearer indications when parameter or software updates are required and automatically starts updates when permitted.

PAX-4161: Improvement: Additional information is now displayed to clarify when cancellation is and is not possible.

Pax Release 1.3.0.12

PAX-4213: To improve traceability, SalesTransactionId has now been added to the return message sent to VAS for APM transactions (requested by Ziklo).

PAX-4212: Fixed an issue where, in certain scenarios, such as a fallback from a CTLS purchase in offline mode using Dankort in a digital wallet, the terminal could incorrectly prompt the customer to insert the card’s chip (reported by Reitan DK).

PAX-4207: New functionality: Support for forwarding PAR (Payment Account Reference) to the POS, provided that the response from the host contains it.

PAX-4204: General product improvement: Stand-alone terminals now return to the main menu if no activity is registered within 30 seconds after a transaction has been initiated (reported by Support – CNMT-131).

PAX-4191: Updated logic for handling signature-based purchases performed on Stand-alone terminals, following the observation of several incorrect behaviors.

PAX-4167: New functionality: Support for Non-Payment Token (same functionality as for Online), which can serve as a bridge between the terminal and e-commerce.

PAX-4166: ECR on Device configuration: The terminal now displays the transaction result (approved/declined) for a longer period before handing control back to the POS.

PAX-4120: Fuel-specific: The terminal now disables the CTLS reader when MiFare DESFire cards are used, allowing the magnetic stripe to be swiped.

PAX-4093: Fix: The terminal no longer cancels a purchase when a display message times out if the purchase has already been approved and the receipt has been delivered (reported by Ziklo).

Pax Release 1.3.0.11

PAX-4189 When both the Terminal and Card support Dankort, Dankort will always be selected for ‘Purchase with Cashback’ transactions.

PAX-4160 The accessibility mode button can now be hidden from the menu via TMS.

PAX-4147 Improve configuration of APN settings for SIM-cards with known ICCID prefix. Now, the payment application will, when one of “our” SIM Cards is detected on startup, try to add and use an APN using ‘internet.cxn’ if the current APN is not set to ‘internet.cxn’.

PAX-4146 Improved Apm event handling

PAX-4143 Removed pairing mode from standalone menu

PAX-4142 Reports button only visible in standalone mode

PAX-4129 ECR error screen will no longer be shown if configuration message to ECR is not received

PAX-4082 Improved downloading software to terminal so we do not get parallel download’s

PAX-4076 A reversal after an APM transaction no longer faultily reverse the last card transaction.

PAX-4025 Improved log upload to prevent the terminal from timing out during a long log upload job

PAX-3818 In the event of an ECR connection error is triggered during a transaction process, the error will not be visible until it after transaction flow is complete

Pax Release 1.3.0.10

PAX-4119 Can now receive loyalty accounts from host

PAX-4117 Can now requets and receive cloud logs via intents

PAX-4099 Fixed an issue causing footer logo to behave unexpected on start of transaction on screen change

PAX-4098 Added pairing option in cashier menu when using cloud connect.

PAX-4097 Fixed an issue preventing the transaction outcome loader animation from animating outcome

PAX-4075 Fixed a bug where the terminal could end up using a wrong CVM method for EMV cashback transactions

PAX-4062 Terminal now support ecr cloud communication

Pax Release 1.3.0.9

PAX-4091 Improve selectable profile start up check

PAX-4089 A small fix to set APM error to false so we not showing the error text if we retry a APM payment after getting internet.

PAX-4088 Improved initialising flow in terminal start up.

PAX-4083 Set a 30 second callTimeout in the acquirer-client. To make sure the terminal does not hang more than 30 seconds waiting for a response during poor network conditions (where the existing connect and read timeouts doesn’t trigger).

PAX-4066 Terminal will now retry to send apm cancel message every 2 minutes

PAX-4064 Admin menu item ‘Switch ECR mode’ is now hidden when terminal is configured with an unselectable ECR profile.

PAX-4047 ‘Purchase with cashback’ is now (by default) hidden on Standalone terminals. Merchants that wants to support ‘Purchase with cashback’ must use the Admin-menu to make it visible.

PAX-4041 Ignore Client Only ECRs trying to abort transactions when it is not allowed (or using Wrong Service ID or Device ID when trying to abort something). (Instead of trying to send them a notification they cannot receive)

PAX-4038 Added serial number to system info

PAX-4019 For simplification in the setup of new terminals, improvements has been implemented to when and how the setup screens for admin password, manager password and merchant verification are triggered.

PAX-4018 Blind mode is implemented and available from the localization menu. After activation it will be on until one transaction is complete. The screens in the payment process will have speech, and own pin pad for blind on terminals with on screen pin pad.

PAX-4014 Fix localization of ‘Internet via USB’ admin-menu option

PAX-3221 Implemented new branding system

Pax Release 1.3.0.8

PAX-4042 Improved application update implementation

PAX-4032 Application now handles Apm problem event correctly

PAX-4015 Added more possible APK installation failure reasons

PAX-4011 Solved an issue where amounts from previous transaction was visible on tip screen.

PAX-4004 When running ECR on Device mode the footer menu will now be available on please wait screen.

PAX-4002 Fixed issues with multiple software downloads

PAX-4001 Remove POI-ID field from ECR Settings on the A920Pro. Never meant to be used.

PAX-3993 Update Installer - Allowing it to retry launching the Payment Application. Also: Provide some debug info on bottom of display, if something fails prematurely in the Installer, in order to provide information to us on what/where stuff actually fails, so that we can try to fix that later. Note: The Installer provided in 1.3.0.8 will not be used before upgrading or downgrading from this specific version. Meaning: It does not come into play when performing an upgrade from 1.3.0.x to 1.3.0.8.

PAX-3975 The ready screen now informs if external ECR app is not installed in ECR mode (embedded).

PAX-3973 Terminal now support selectable ecr profile

PAX-3852 Some mastercards that would be declined will now correctly fallback to chip instead.

PAX-3838 A default APN will now be automatically created on terminals with a ‘Swedbank Pay’ flavored SIM-card installed. Requires:

• Mobile Network Enabled
• No APN previously configured
• ICCID of SIM-Card recognized

Pax Release 1.3.0.7.1

PAX-4007 Make sure the KSN used for the Online-PIN block is incremented when needed.

Pax Release 1.3.0.7

PAX-3996 ‘Graceful abort’ from ECR now work as intended again.

PAX-3995 Solved an issue causing a ConcurrentModificationException being triggered.

PAX-3979 Improved acquire-card and authorise flow for plugin-app.

PAX-3977 Implemented required flag in android 10 for sending “move to foreground” intent.

PAX-3967 Fixed application randomly restarting when trying to display the ‘Present Card’ fragment.

PAX-3966 Improved text when asking for second card.

PAX-3957 Change encoding of special characters in the receipts provided to ECRs on nexo-Retailer.

PAX-3953 Modified how an external app is started from the payment app. An External app will now not be started right after installation, but first when the payment app is done initializing and when ready on the initialized screen.

PAX-3946 Improved initial ECR setup by removing redundant Save-buttons, resetting input on cancellation and overwriting entire port input field.

PAX-3944 Improved APM refund input field.

PAX-3943 Fixed issues triggered by changing the orientation of the app.

PAX-3942 Fixed bug where amount was not displayed on APM refund receipt.

PAX-3937 Implemented a more informative installation prosess of external apps. More accurate fail reasons will now be sent to TMS on failure.

PAX-3908 Merchant verification is limited to terminals in ECR mode ‘standalone’.

PAX-3905 Plugin cancel reason is now added to payment-response.

PAX-3904 Functionality to change idle background color for branding purposes.

PAX-3843 Improved cancellation handling for QR-payment.

PAX-3842 The terminal will now increment the KSN on new authorization attempt(s) after a SCA response(s).

PAX-3840 Fixed ‘Print Response’ from the Terminal, so that it always conforms with the nexo-retailer XSD schema.

PAX-3411 Added Norwegian, Swedish, Finnish and Danish translations for menu items.

Pax Release 1.3.0.6.1

PAX-3918 Fixed an issue with using ECR on device with Intent on Android 10.

Pax Release 1.3.0.6

PAX-3932 Terminal will no longer trigger ‘Application Selection’ when using the YELLOW key, when the configured Country Code is not Norway or Denmark.

PAX-3910 The terminal will now respect the TMS configuration set for ‘Preferred application’ for AID A0000001214712 (previously this specific AID was always being set to ‘preferred’).

PAX-3899 When both the Terminal and Card support BankAxept, BankAxept will always be selected for ‘Purchase with Cashback’ transactions.

PAX-3895 We now add terminal type 9F35 to icc data.

PAX-3894 Only start business apps once after boot up.

PAX-3892 Fixed issue with no message sent after cancel when running terminal with ECR on device.

PAX-3886 Improve behavior when aborting Application Selection

PAX-3871 Fixed a bug where the application would get stuck if card was removed during application selection on Card Acquisition.

PAX-3850 Display MAC address on ‘System info’.

PAX-3849 ‘Application Selection’ for Chip/Contact now works properly on the next transaction, after being aborted.

PAX-3848 The Terminal will now properly reverse transactions in scenarios where the terminal first has gotten a SCA response from host and then need to authorize again after PIN-entry (or Chip+PIN). Relevant for nexo-Acquirer (not SPDH).

PAX-3845 Added fallback indicator to plugin app message.

PAX-3837 Fixed an issue that caused tip not to included after canceling an APM transaction.

PAX-3833 Payment app will start business applications when boot has completed, instead of as part of its initialisation process.

PAX-3830 Network check flow on initializing terminal updated with new flow and design.

PAX-3827 Implemented new functionality for opening ECR on device. Including app name in menu and check if the app is already opened or not.

PAX-3811 Decision screens updated to new design.

PAX-3780 Removed option to export logs to local folder on terminal.

PAX-3779 Delete old, exported logs from the terminal. In order to free up space on the disk.

Pax Release 1.3.0.5.1

PAX-3833 Payment app will start business applications when boot has completed, instead of as part of its initialisation process.

Pax Release 1.3.0.5

PAX-3847 Improved clearing of sent TMS events.

PAX-3828 Implemented the ability to control the max allowed tip percentage of total amount that can be added on custom tip amount screen.

PAX-3821 Switching language now works again (when only two languages available).

PAX-3807 Fixed a bug where the application would get stuck if starting a payment failed when running as Embedded.

PAX-3804 Updated design on ECR settings screen.

PAX-3803 Improved payment-response handling.

PAX-3800 Fixed an issue with back button text on APM screen on A30.

PAX-3798 Fixed a bug where the terminal would not understand that connection to the ECR was restored after a network breakdown at a specific point during a transaction.

PAX-3792 QR code will now correctly update on new terminal port during the ECR setup stage.

PAX-3785 Improved footer on error screens.

PAX-3784 Improved abortrequest handling.

PAX-3781 All business apps are now started on boot; not just those stopped by the OS.

PAX-3778 The zipped logfile is now deleted from the Terminal after upload is complete.

PAX-3772 Padding adjusted on tip info line on present card screen on A30.

PAX-3771 Added ability to activate internet via USB on A35 in admin menu without first getting parameters from TMS.

PAX-3769 Fixed a bug where input fields in the ECR settings would not be saved unless explicit green button was pressed on some terminal models.

PAX-3762 Terminal will now use default receipt print settings if options is removed in TMS, on A920 without requiring restart.

PAX-3727 Implemented new system for controlling tip/extra options from TMS.

PAX-3716 Added mapping for host response code 1B.

PAX-3714 Design updated on present card screen.

PAX-3654 Improvements in the CHIP Refund flow (As some VISA cards were previously declined locally due to wrong conditions being checked).

PAX-3646 Design updated on tip screen.

PAX-3271 Terminal is now easier to navigate using hardware buttons.

Pax Release 1.3.0.4

PAX-3773 Improved client cancellation handling.

PAX-3761 Terminal now gives option to edit terminal port on ECR setup screen.

PAX-3745 The merchant receipt will no longer contain a SignatureBlock when Magstripe + PIN has been used.

PAX-3741 Fixed an issue with UI scaling on some terminals.

PAX-3740 Improved save button design on ECR initial setup screens.

PAX-3733 Fix swedish translation for no more pin attempts.

PAX-3725 Fixed an issue that certain scenarios triggered multiple messages to the ECR when aborting a transaction.

PAX-3723 Improved card acquisition cancelling.

PAX-3715 Added check and option for network settings when on load terminal initialization screen.

PAX-3705 Increase the ‘connect timeout’ from 3 to 5 seconds (on the Acquirer connection).

PAX-3704 Fixed a bug where the terminal would be stuck on Input Request after user requests Application Selection.

PAX-3685 Minor standalone main menu icon update.

PAX-3678 Will no longer prompt for ECR settings when running as Embedded.

PAX-3677 Minor design update to admin menu.

PAX-3671 Design update on menu buttons.

PAX-3670 Design updated on transaction outcome loader.

PAX-3669 Design update on warning screens.

PAX-3657 Fixed an issue causing buttons on screen to behave incorrectly when prompted to insert card.

PAX-3655 Fixed a visual error in the language menu on some screens.

PAX-3617 Added support for ‘Amount Based Application Selection’.

PAX-3456 Added more information and options on terminal activation screen.

PAX-3125 Cashback is not allowed when using magstripe.

PAX-1381 Will notify ECR through display request when terminal cannot update config due to offline transactions.

.Net SDK 1.3.25328

• Added support for cloud
• changed order of Payment Arguments

.Net SDK 1.3.25253

• This release updates the library’s logging dependencies from NLog v4 to NLog v6. Applications that directly use NLog alongside this library must also update to NLog v6 for compatibility. If your application does not use NLog directly, no changes are required on your side.

.Net SDK 1.3.25252

• Added custom version handling
• Added support for tips
• Added Loyalty flag to SaleAppInfo
• Added Card Acqusition data
• Various bugfixes and Improvements

.Net SDK 1.3.25120.1

• New boolean flag in SaleApplInfo ForceAcquisitionReference, that when set to true always requires a cardAquisition before PaymentRequest.

.Net SDK 1.3.24170

• Add specific data from fuel app to the receiptBlob

.Net SDK 1.3.24163

• If installed POS language is not supported by terminal as operator language, use english.
• Only send continue_processing if Continue is called. Don’t send continue_processing automatically on Payment.

.Net SDK 1.3.24129

• PaymentRequetsResult now with new properties, MerchantReceiptBlob, MerchantReceiptBlobNoHeader and SignatureBlock.

.Net SDK 1.3.24075

• Fixed bug for fuel that caused SaleItems to be missed when starting with GetPaymentInstrument.

.Net SDK 1.3.24066

• New package ID. SwedbankPay.Pax.Sdk. Still the same namespaces and dll name.
• Fix for display messages from fuel app that lacks text id.
• Added support for AdminRequest with service identification OM02, OM03 and OM04, regarding the Store-And-Forward.
• Fixed bug for PrintRequest with DocumentQualifier other other than CashierReceipt or CustomerReceipt.
• Possibility for Net Framework 4.0. Now supports Netstandard2.0, net framework 4.5 and 4.0.

.Net SDK 1.3.24047

• PaymentRequestResult now populates ProductName and PAN even if PaymentInstrumentData is missing.
• Possibility to use OpenEx or OpenExAsync to set OperatorID and ShiftNumber that will be forwarded and seen in reports.
• Possibility to attach purchase order Id by setting in in TransactionSetup when starting a payment.
• Setting up the logfile will only be made once even if new instances is created. Filter is removed when calling Stop.
• Calling Stop will stop and remove the listener.
• SplitPayment may be indicated in TranactionSetup and is sent to terminal to be forwarded to host.
• Property type of TransactionSetup is always overridden and set to Refund if Refund or RefundAsync is called.
• Default currency fixed when using TransactionSetup.

.Net SDK 1.3.24025

• RequestToDisplay and UpdateTerminal have now corrected results.
• ReverseLast now automatically makes retries if the terminal responds busy.
• OnTerminalAddressObtainedEventCallback now with correct access modifier to be able to access Ipv4 and Port properties.

.Net SDK 1.3.24016

• CardAcquisitionReference is now a copy of POITransactionID. Earlier time was converted to local time and caused problem when an other timezone was used.
• PaymentRequetsResult has now a lot of properties to make values easily available.

.Net SDK version 1.3.23348

• CVM signature transaction works just the same for Client Only mode as for default Client and Server mode.
• ConfirmationHandler callback is a must even for Client Only mode.
• EventCallback for PrintRequestEventCallback is a must even for Client Only mode.
• Code Examples updated.

.Net SDK Version 1.3

• Extended interface with function RequestToPrint.
• Extended TransactionSetup with a list of SaleItem to be used with fuel functionality.
• ReceiptBlob and ReceiptBlobNoHeader has been shortened and compressed.

.Net SDK Version 1.2

• SDK for .Net has extended its interface with new methods for GetPaymentInstrument, Payment and Refund for which an object with parameters is passed. This was made to be able set a transaction id from the sale system.
• ReceiptBlobNoHeader has been added to PaymentRequestResult.