From e803163501c1e375fa50bfba80de8f026bce5cc7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Anders=20J=C3=A4rold?= Date: Wed, 6 Mar 2024 19:34:58 +0100 Subject: [PATCH 01/11] updated and also a new card under Net --- _includes/pax-netshaddurlacl.md | 6 ++++++ pax-terminal/NET/CodeExamples/index.md | 7 +------ pax-terminal/NET/avoid-privilige-elevation.md | 10 ++++++++++ 3 files changed, 17 insertions(+), 6 deletions(-) create mode 100644 _includes/pax-netshaddurlacl.md create mode 100644 pax-terminal/NET/avoid-privilige-elevation.md 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..1a4a0b089b --- /dev/null +++ b/pax-terminal/NET/avoid-privilige-elevation.md @@ -0,0 +1,10 @@ +--- +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 +icon: + content: verified_user + outlined: true +--- +{%include pax-netshaddurlacl.md%} From ede58620850bc135ddd505393c09341914f5b533 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Anders=20J=C3=A4rold?= Date: Wed, 6 Mar 2024 19:39:16 +0100 Subject: [PATCH 02/11] fixed --- pax-terminal/NET/tutorial/payment-with-orderid.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 }; From 7b681d3a528e8836ba551e7abf644ab7af45eb92 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Anders=20J=C3=A4rold?= Date: Wed, 6 Mar 2024 19:48:13 +0100 Subject: [PATCH 03/11] updated --- pax-terminal/NET/release-notes.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/pax-terminal/NET/release-notes.md b/pax-terminal/NET/release-notes.md index 823b02d32c..c81b744ba8 100644 --- a/pax-terminal/NET/release-notes.md +++ b/pax-terminal/NET/release-notes.md @@ -10,6 +10,16 @@ icon: outlined: true --- +## March 6 2024 + +### .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 From 981f750b05e5aaad7346273bfa5348e1d260fe39 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Anders=20J=C3=A4rold?= Date: Wed, 6 Mar 2024 20:50:39 +0100 Subject: [PATCH 04/11] Comment on AcuirerData --- _includes/pax-acquirerdata.md | 8 ++++++++ pax-terminal/NET/includes/acquirerdata.md | 12 ++++++++++++ pax-terminal/NET/includes/transactionsetup.md | 5 +++-- 3 files changed, 23 insertions(+), 2 deletions(-) create mode 100644 _includes/pax-acquirerdata.md create mode 100644 pax-terminal/NET/includes/acquirerdata.md 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/pax-terminal/NET/includes/acquirerdata.md b/pax-terminal/NET/includes/acquirerdata.md new file mode 100644 index 0000000000..e4e858231e --- /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 From 65df1fb2822210ab9d5d52db8f2302570f80eab0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Anders=20J=C3=A4rold?= Date: Wed, 6 Mar 2024 21:18:22 +0100 Subject: [PATCH 05/11] corrected permalink of acquirerdata --- pax-terminal/NET/includes/acquirerdata.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pax-terminal/NET/includes/acquirerdata.md b/pax-terminal/NET/includes/acquirerdata.md index e4e858231e..bb6db1d481 100644 --- a/pax-terminal/NET/includes/acquirerdata.md +++ b/pax-terminal/NET/includes/acquirerdata.md @@ -2,7 +2,7 @@ title: AcquirerData description: | The content is base64 encoded and sent to the terminal i SaleToAcquirerData in a PaymentRequest -permalink: /:path/AcquirerData/ +permalink: /:path/acquirerdata/ hide_from_sidebar: true --- ### Special data sent to host From 24495e3fdaf2ea9977390ad8389025265abb106e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Anders=20J=C3=A4rold?= Date: Wed, 6 Mar 2024 21:23:33 +0100 Subject: [PATCH 06/11] fixed menu order, and sidebar for card avoid privilege --- pax-terminal/NET/avoid-privilige-elevation.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/pax-terminal/NET/avoid-privilige-elevation.md b/pax-terminal/NET/avoid-privilige-elevation.md index 1a4a0b089b..a9ea3754fd 100644 --- a/pax-terminal/NET/avoid-privilige-elevation.md +++ b/pax-terminal/NET/avoid-privilige-elevation.md @@ -3,8 +3,10 @@ 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%} From 848eb49fcbed3566c39d775c35d09258ee3a49e3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Anders=20J=C3=A4rold?= Date: Wed, 6 Mar 2024 21:51:10 +0100 Subject: [PATCH 07/11] permalink fix, but no effect --- pax-terminal/NET/avoid-privilige-elevation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pax-terminal/NET/avoid-privilige-elevation.md b/pax-terminal/NET/avoid-privilige-elevation.md index a9ea3754fd..e99b4389fb 100644 --- a/pax-terminal/NET/avoid-privilige-elevation.md +++ b/pax-terminal/NET/avoid-privilige-elevation.md @@ -2,7 +2,7 @@ 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 +permalink: /:path/avoid-privilige-elevation/ hide_from_sidebar: true icon: content: verified_user From c18f9a360e9f8f64f2d516d399869ae20b5cf9d8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Anders=20J=C3=A4rold?= Date: Thu, 7 Mar 2024 08:43:52 +0100 Subject: [PATCH 08/11] fixed permalink for purchase order --- pax-terminal/Nexo-Retailer/submit-purchse-order-number.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 From 6b46fc55494a6c254ece0f9915beceb88424db24 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Anders=20J=C3=A4rold?= Date: Thu, 7 Mar 2024 16:40:11 +0100 Subject: [PATCH 09/11] Changed icon for cards about autconfiguration --- pax-terminal/NET/tutorial/autoconfigurepos.md | 2 +- pax-terminal/Nexo-Retailer/auto-configure-ecr-2-terminal.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) 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/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 --- From 016794d4809e793e4f72ab2971de6ef8c32581eb Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Anders=20J=C3=A4rold?= Date: Mon, 11 Mar 2024 14:15:27 +0100 Subject: [PATCH 10/11] Changed icon for auto configuration --- pax-terminal/NET/tutorial/autoconfigurepos.md | 2 +- pax-terminal/Nexo-Retailer/auto-configure-ecr-2-terminal.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) 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/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 --- From 2005b7529f03bf4cac241b0c4e7bc499e0e73fe9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Anders=20J=C3=A4rold?= Date: Mon, 18 Mar 2024 09:28:19 +0100 Subject: [PATCH 11/11] updated release notes under NET --- pax-terminal/NET/release-notes.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/pax-terminal/NET/release-notes.md b/pax-terminal/NET/release-notes.md index c81b744ba8..4b9381b623 100644 --- a/pax-terminal/NET/release-notes.md +++ b/pax-terminal/NET/release-notes.md @@ -12,6 +12,10 @@ icon: --- ## 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. @@ -91,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