Merge pull request #2163 from SwedbankPay/develop-pos

Develop pos
SwedbankPay · Mar 18, 2024 · 46d3bd3 · 46d3bd3
2 parents 5d01967 + 2005b75
commit 46d3bd3
Show file tree

Hide file tree

Showing 11 changed files with 61 additions and 12 deletions.
diff --git a/_includes/pax-acquirerdata.md b/_includes/pax-acquirerdata.md
@@ -0,0 +1,8 @@
+{:.code-view-header}
+**Possible values in AcquirerData. Either any of them or both**
+
+```json
+
+{"purchaseOrderNumber":"<ordernumber>","loyaltyPan":"<pan>"}
+
+```
diff --git a/_includes/pax-netshaddurlacl.md 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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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