Adyen

In this article

Setup

Support

All settings to communicate with the terminal are accessible in the Adyen portal (log on from adyen.com).

Setup

There are two connections available for Adyen, Local and Cloud.

Mutual settings

Apart from the default settings indicating the selection, there are a few mutual settings both connection types share:

  • Merchant ID is the unique ID of the merchant in the Adyen portal.
  • Terminal ID is the unique ID of the PED as shown in the Adyen portal.
  • Unique identifier of the ECR indicates from where the transaction originates.
  • Timeout indicates, in seconds, for how long a communication is kept alive.
  • Number of characters in the receipt line. The default value is set to 40 characters, the same as in LS Central.
  • Swipe gift card. If value is set to false, the gift card number must be entered manually on the PED.
  • Enable cashback. Set to true, if cashback will be used.

Cloud

When you select a cloud connection, LS Pay will communicate with the Adyen gateway and the Adyen gateway will handle the communication to the PED. In this way, it does not matter where the PED connects, it is always reachable.

The offside is that the network must be active, both from the POS/ECR and the PED, it does not cater for offline transactions.

  • Modification endpoint, the default value is set to test environment (https://pal-test.adyen.com).
  • URL Prefix is needed when communicating with live environment, the prefix is accessible in the Adyen portal.
  • Terminal API endpoint, the default value is set to test environment (https://terminal-api-test.adyen.com/sync)
  • API Key is created and managed in the Adyen portal. Note: Make sure the key is safely stored.

Local

When you select local connections, LS Pay will communicate straight to the PED and the PED handles communication to the Adyen gateway. In this way it has full support for offline transactions.

The offside is that it does not support all pre-authorization processes or tokens.

  • IP Address of the terminal, make sure the PED is on the same network as the POS.
  • Key identifier for the local connection. The key is managed in the Adyen portal.
  • Key pass phrase for the local connection. The pass phrase is managed in the Adyen portal.

Support

EFT

Adyen supports the core EFT functions available in LS Pay:

  • Purchase
    • Tips on PED, managed in the Adyen portal.
    • MOTO payments (Mail Order Telephone Order).
    • QR payments using a QR code scanned by the merchant.
  • Refund
    • Stand-alone refund (no previous purchase).
    • Referenced refund (linked to previous purchase).
      1. Full referenced refund.
      2. Partial referenced refund.

      Note: A referenced transaction can only be partially refunded once.

  • Void
    • Can void any previous transaction.
  • Get last transaction
    • Gets the last transaction processed in the Adyen portal.
  • Cancel
    • Possible to cancel both on PED and from POS/ECR.

Pre-authorization

Pre-authorizations are supported using cloud communication. Even if initiating a pre-authorization is accessible using local connection, it is not possible to manage or finalize using local, only through cloud.

  • Pre-authorization
  • Update pre-authorization to update amount or to prolong the authorization.
  • Cancel pre-authorization to release the amount.
  • Finalize pre-authorization to confirm the amount used for the transaction.

Printing

Adyen PEDs that have printers (like V400m) can receive print requests from LS Pay, using interfaces IPrinterService and IRecieptPrinting.

Copy

Print receipt

public async Task PrintReceiptLine(ReceiptLine receiptLine)
{
    if (receiptLine != null)
    {
        List<ReceiptLine> lines = new List<ReceiptLine>();
        lines.Add(receiptLine);

        if(eaManagement is IPrinter)
        {
            IPrinterService printerService = ((IPrinter)this.eaManagement).GetPrinterService();
            printerService.PrintingEvent += OnPrintEvent;

            if (printerService is IReceiptPrinting)
            {
                await ((IReceiptPrinting)this.printerService).PrintAsync(lines);
            }
        }
    }
}

Gift cards

Gift card features have been added to the integration:

  • Activate
  • Add value
  • Balance inquiry
  • Close card
  • Deactivate