Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Develop pos #2163

Merged
merged 16 commits into from
Mar 18, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions _includes/pax-acquirerdata.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
{:.code-view-header}

Check notice on line 1 in _includes/pax-acquirerdata.md

View check run for this annotation

Codacy Production / Codacy Static Code Analysis

_includes/pax-acquirerdata.md#L1

First line in a file should be a top-level heading
**Possible values in AcquirerData. Either any of them or both**

```json

{"purchaseOrderNumber":"<ordernumber>","loyaltyPan":"<pan>"}

```
6 changes: 6 additions & 0 deletions _includes/pax-netshaddurlacl.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
{% include alert.html type="informative" icon="info" header="Heads up"

Check notice on line 1 in _includes/pax-netshaddurlacl.md

View check run for this annotation

Codacy Production / Codacy Static Code Analysis

_includes/pax-netshaddurlacl.md#L1

First line in a file should be a top-level heading
body="When running as a server the program needs elevated privileges. It may be avoided by entering the following command as administrator:" %}

Check notice on line 2 in _includes/pax-netshaddurlacl.md

View check run for this annotation

Codacy Production / Codacy Static Code Analysis

_includes/pax-netshaddurlacl.md#L2

Expected: 80; Actual: 143
{% include alert.html type="informative" body="
netsh http add urlacl url=http://*:11000/EPASSaleToPOI/3.1/ sddl=D:(A;;GX;;;WD)" %}

Check notice on line 4 in _includes/pax-netshaddurlacl.md

View check run for this annotation

Codacy Production / Codacy Static Code Analysis

_includes/pax-netshaddurlacl.md#L4

Expected: 80; Actual: 87
{% include alert.html type="informative" body="
where :11000 is the default port. If listening to another port the command must be changed." %}

Check notice on line 6 in _includes/pax-netshaddurlacl.md

View check run for this annotation

Codacy Production / Codacy Static Code Analysis

_includes/pax-netshaddurlacl.md#L6

Expected: 80; Actual: 99
7 changes: 1 addition & 6 deletions pax-terminal/NET/CodeExamples/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
12 changes: 12 additions & 0 deletions pax-terminal/NET/avoid-privilige-elevation.md
Original file line number Diff line number Diff line change
@@ -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%}
12 changes: 12 additions & 0 deletions pax-terminal/NET/includes/acquirerdata.md
Original file line number Diff line number Diff line change
@@ -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%}
5 changes: 3 additions & 2 deletions pax-terminal/NET/includes/transactionsetup.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
Expand All @@ -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
15 changes: 15 additions & 0 deletions pax-terminal/NET/release-notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,20 @@
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.

Check notice on line 21 in pax-terminal/NET/release-notes.md

View check run for this annotation

Codacy Production / Codacy Static Code Analysis

pax-terminal/NET/release-notes.md#L21

Expected: 80; Actual: 94
* 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

Check notice on line 23 in pax-terminal/NET/release-notes.md

View check run for this annotation

Codacy Production / Codacy Static Code Analysis

pax-terminal/NET/release-notes.md#L23

Expected: 80; Actual: 115
* Fixed bug for PrintRequest with DocumentQualifier other other than CashierReceipt or CustomerReceipt.

Check notice on line 24 in pax-terminal/NET/release-notes.md

View check run for this annotation

Codacy Production / Codacy Static Code Analysis

pax-terminal/NET/release-notes.md#L24

Expected: 80; Actual: 105
* 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
Expand Down Expand Up @@ -81,3 +95,4 @@
[eventcallback]: /pax-terminal/NET/SwpTrmLib/ISwpTrmCallbackInterface/
[codeexamples]: /pax-terminal/NET/CodeExamples
[paymentrequestresult]: /pax-terminal/NET/includes/paymentrequestresult
[acquirerdata]: /pax-terminal/NET/includes/acquirerdata
2 changes: 1 addition & 1 deletion pax-terminal/NET/tutorial/autoconfigurepos.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ description: |
permalink: /:path/autoconfigurepos/
hide_from_sidebar: true
icon:
content: settings_ethernet
content: settings_suggest
outlined: true
menu_order: 65
---
Expand Down
2 changes: 1 addition & 1 deletion pax-terminal/NET/tutorial/payment-with-orderid.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
};
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
---
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Loading