diff --git a/_includes/pax-acquirerdata.md b/_includes/pax-acquirerdata.md new file mode 100644 index 0000000000..3c70ab7470 --- /dev/null +++ b/_includes/pax-acquirerdata.md @@ -0,0 +1,8 @@ +{:.code-view-header} +**Possible values in AcquirerData. Either any of them or both** + +```json + +{"purchaseOrderNumber":"","loyaltyPan":""} + +``` diff --git a/_includes/pax-netshaddurlacl.md b/_includes/pax-netshaddurlacl.md new file mode 100644 index 0000000000..0e1260a9b4 --- /dev/null +++ b/_includes/pax-netshaddurlacl.md @@ -0,0 +1,6 @@ +{% include alert.html type="informative" icon="info" header="Heads up" +body="When running as a server the program needs elevated privileges. It may be avoided by entering the following command as administrator:" %} +{% include alert.html type="informative" body=" + netsh http add urlacl url=http://*:11000/EPASSaleToPOI/3.1/ sddl=D:(A;;GX;;;WD)" %} +{% include alert.html type="informative" body=" + where :11000 is the default port. If listening to another port the command must be changed." %} diff --git a/pax-terminal/NET/CodeExamples/index.md b/pax-terminal/NET/CodeExamples/index.md index ad11527d5c..bac0119f4e 100644 --- a/pax-terminal/NET/CodeExamples/index.md +++ b/pax-terminal/NET/CodeExamples/index.md @@ -155,12 +155,7 @@ Based on [*Simplest Client only*][simplest-client] the following runs as a serve * Subscribed to the `OnTerminalDisplay` event * Added code to the callback `EventNotificationHandler` -{% include alert.html type="informative" icon="info" header="Heads up" -body="When running as a server the program needs elevated privileges. It may be avoided by entering the following command as administrator:" %} -{% include alert.html type="informative" body=" - netsh http add urlacl url=http://*:11000/EPASSaleToPOI/3.1/ user=Everyone" %} -{% include alert.html type="informative" body=" - where :11000 is the default port. If listening to another port the command must be changed." %} +{% include pax-netshaddurlacl.md %} {:.code-view-header} Simplest Client And Server form of implementation - Happy Flow diff --git a/pax-terminal/NET/avoid-privilige-elevation.md b/pax-terminal/NET/avoid-privilige-elevation.md new file mode 100644 index 0000000000..e99b4389fb --- /dev/null +++ b/pax-terminal/NET/avoid-privilige-elevation.md @@ -0,0 +1,12 @@ +--- +title: Avoid Privilege Elevation +description: | + When running as a server the HttpListener is used which normally requires an elevation of privileges +permalink: /:path/avoid-privilige-elevation/ +hide_from_sidebar: true +icon: + content: verified_user + outlined: true +menu_order: 20 +--- +{%include pax-netshaddurlacl.md%} diff --git a/pax-terminal/NET/includes/acquirerdata.md b/pax-terminal/NET/includes/acquirerdata.md new file mode 100644 index 0000000000..bb6db1d481 --- /dev/null +++ b/pax-terminal/NET/includes/acquirerdata.md @@ -0,0 +1,12 @@ +--- +title: AcquirerData +description: | + The content is base64 encoded and sent to the terminal i SaleToAcquirerData in a PaymentRequest +permalink: /:path/acquirerdata/ +hide_from_sidebar: true +--- +### Special data sent to host + +This field is used for special purposes and is normally left empty. + +{%include pax-acquirerdata.md%} diff --git a/pax-terminal/NET/includes/transactionsetup.md b/pax-terminal/NET/includes/transactionsetup.md index be9dc62c6f..b28011ace4 100644 --- a/pax-terminal/NET/includes/transactionsetup.md +++ b/pax-terminal/NET/includes/transactionsetup.md @@ -23,8 +23,8 @@ TransactionSetup holds properties for a transaction and may be passed as an inpu ``` {:.table .table-striped} -| :------------- | :-------------- |:--------------- |:---| -| string |AcquirerData | Additional data to be sent to host. Used for PurchaseOrderNumber. JSON format | Optional | +| :--- | :--- |:--- |:--- | +| string |[AcquirerData][acquirerdata] | Additional data to be sent to host. Used for sending special data to PosPay and that may be forwarded to other systems for customer purpose. JSON format. Content need to be agreed on | Optional | | decimal |Amount |Total amount | Mandatory | | string |APMReference |Used only if refund of a transaction made using alternative payment method. The reference originates from the response of the APM transaction | Only for Refund of APM transaction | | decimal |CashBack |included in Amount | Optional | @@ -48,3 +48,4 @@ string |TransactionID |A transaction id that may be set by sale system for track ``` [saleitem]: /pax-terminal/NET/includes/saleitem +[acquirerdata]: /pax-terminal/NET/includes/acquirerdata diff --git a/pax-terminal/NET/release-notes.md b/pax-terminal/NET/release-notes.md index 823b02d32c..4b9381b623 100644 --- a/pax-terminal/NET/release-notes.md +++ b/pax-terminal/NET/release-notes.md @@ -10,6 +10,20 @@ icon: outlined: true --- +## March 6 2024 + +* Updated command for avoiding privilege elevation. +* Use case for easier configuration of terminal and POS system. +* Update of [TransactionSetup][transactionsetup] and property [AcquirerData][acquirerdata]. + +### .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. + ## February 27 2024 ### .Net SDK 1.3.24047 @@ -81,3 +95,4 @@ ReceiptBlobNoHeader has been added to PaymentRequestResult. [eventcallback]: /pax-terminal/NET/SwpTrmLib/ISwpTrmCallbackInterface/ [codeexamples]: /pax-terminal/NET/CodeExamples [paymentrequestresult]: /pax-terminal/NET/includes/paymentrequestresult +[acquirerdata]: /pax-terminal/NET/includes/acquirerdata diff --git a/pax-terminal/NET/tutorial/autoconfigurepos.md b/pax-terminal/NET/tutorial/autoconfigurepos.md index 2b858c7708..92ea742c4f 100644 --- a/pax-terminal/NET/tutorial/autoconfigurepos.md +++ b/pax-terminal/NET/tutorial/autoconfigurepos.md @@ -5,7 +5,7 @@ description: | permalink: /:path/autoconfigurepos/ hide_from_sidebar: true icon: - content: settings_ethernet + content: settings_suggest outlined: true menu_order: 65 --- diff --git a/pax-terminal/NET/tutorial/payment-with-orderid.md b/pax-terminal/NET/tutorial/payment-with-orderid.md index b79e5c3b7f..06401f1960 100644 --- a/pax-terminal/NET/tutorial/payment-with-orderid.md +++ b/pax-terminal/NET/tutorial/payment-with-orderid.md @@ -24,7 +24,7 @@ class PaxImplementation : ISwpTrmCallbackInterface public async Task CreatePayment() { - var pr = Pax.PaymentAsync(new TransactionSetup() { + var pr = await Pax.PaymentAsync(new TransactionSetup() { AcquirerData = JsonSerializer.Serialize(new { purchaseOrderNumber = "123456789"}), Amount = (decimal)120 }; diff --git a/pax-terminal/Nexo-Retailer/auto-configure-ecr-2-terminal.md b/pax-terminal/Nexo-Retailer/auto-configure-ecr-2-terminal.md index 9d5ea52a86..cf3b474b9f 100644 --- a/pax-terminal/Nexo-Retailer/auto-configure-ecr-2-terminal.md +++ b/pax-terminal/Nexo-Retailer/auto-configure-ecr-2-terminal.md @@ -4,7 +4,7 @@ permalink: /:path/auto-configure-ecr-2-terminal/ description: | Easier configuration of POS by picking up the terminal address from the configuration message sent from the terminal when pressing **Save** in terminal's admin menu. icon: - content: settings_ethernet + content: settings_suggest outlined: true menu_order: 15 --- diff --git a/pax-terminal/Nexo-Retailer/submit-purchse-order-number.md b/pax-terminal/Nexo-Retailer/submit-purchse-order-number.md index 3b38b0082e..d3bd69708b 100644 --- a/pax-terminal/Nexo-Retailer/submit-purchse-order-number.md +++ b/pax-terminal/Nexo-Retailer/submit-purchse-order-number.md @@ -2,7 +2,7 @@ title: Include Purchase Order Number description: | A Purchase Order Number may be included in the PaymentRequest and will be forwarded to the aquirer host. -permalink: /:path/submit-purchse-order-number +permalink: /:path/submit-purchse-order-number/ menu_order: 65 icon: content: bookmark_add