Adyen

Connecting an Adyen payment terminal to NightPOS Point of Sale allows you to offer customers a smooth payment experience while simplifying the work of cashiers.

Important

• Adyen payment terminals do not require an IoT Box.

• Adyen terminals can be used in many countries, but not worldwide. Check the list of countries supported by Adyen.

• Adyen is more focused on enterprise customers and may require a minimum number of transactions and a minimum processed volume.

See also

• Online payments with Adyen

• List of payment methods supported by Adyen

• List of Adyen terminals

Adyen configuration

Start by creating an Adyen account and ordering a terminal through the Adyen Customer Area. Once you receive the terminal, set up the physical device by following the instructions displayed on the terminal screen.

To connect the Adyen terminal to NightPOS, you need to:

• Generate an Adyen API key.

• Locate the Adyen terminal identifier.

• Locate the merchant account name.

• Set the event URLs.

Tip

Log in to your Test account to try the integration without charging customers. Switch to your Live account once you are ready to accept payments.

See also

• Adyen Docs - Payment terminal quickstart guides

• NightPOS Point of Sale: Adyen tutorial

Generate an Adyen API key

The Adyen API key is used to authenticate requests from the Adyen terminal. To generate an API key:

1. Go to your Adyen Customer Area.

2. Navigate to Developers ‣ API credentials in the left menu.

3. Select existing credentials or create new ones:

   1. Click Create new credential.

   2. In the Create API credential pop-up window, select Web service user as Credential type.

   3. Optionally, enter a Description.

   4. Click Create credential.

4. In the Server settings section of the Configure API credential page, click Generate API key next to the API key field.

5. Click the (Copy API key) icon and save the value for the NightPOS configuration step.

6. Click Save changes.

See also

Adyen Docs - API credentials

Locate the Adyen terminal identifier

The Adyen terminal identifier, also known as the POIID, is the terminal’s unique string used to identify the physical payment terminal.

To locate this identifier:

1. Go to your Adyen Customer Area.

2. Navigate to In-person payments ‣ Payment devices to view a list of all your devices.

   Tip

   Active devices are marked with a (green dot) icon.

3. Select the terminal to connect.

   Tip

   If you have multiple devices, identify your terminal using the serial number printed on the back of the device.

4. On the Settings page, click the terminal identifier to copy it to the clipboard and save the value for the NightPOS configuration step.

   

   Info

   The terminal identifier combines the device model and serial number, e.g., S1F2L-000158215112256.

Locate the merchant account name

To locate the merchant account name:

1. Go to your Adyen Customer Area.

2. Navigate to In-person payments ‣ Payment devices to view a list of all your devices.

3. Select the terminal to connect.

4. In the terminal’s settings, click the Merchant name.

5. Click the merchant account name to copy it to the clipboard and save the value for the NightPOS configuration step.

   

Set the event URLs

To allow NightPOS to receive payment notifications, you must configure the terminal Event URLs. To do so,

1. Go to your Adyen Customer Area.

2. Navigate to In-person payments ‣ Payment devices to view a list of all your devices.

3. Select the terminal to connect.

4. In the terminal settings, select Integrations from the left menu.

   Important

   Ensure you are configuring the Terminal level terminal settings, not the Merchant level terminal settings.

   

5. Set the Switch to decrypted mode to edit this setting field to Decrypted.

6. Click Add new or edit an existing URL by clicking the pencil icon.

7. On the Add URL or Edit URL pop-up window, paste the Event URL from NightPOS’s payment method form.

   Info

   The Event URL is composed of the server address, followed by /pos_adyen/notification.

8. If needed, enter a Username (optional) and Password (optional), define if the URL is Public or Local, and toggle Enable encryption on/off.

9. Click Add URL, or when editing an existing URL, Edit URL.

10. Click Save at the bottom of the page.

11. Switch to Encrypted mode.

NightPOS configuration

To configure Adyen for NightPOS, you first need to enable Adyen and create the payment method. Then, configure the Adyen-specific settings on the payment method form:

1. Paste the following values into their corresponding fields:

   • The generated API key into the Adyen API key field.

   • The located terminal identifier into the Adyen Terminal Identifier field.

   • The merchant account name into the Adyen Merchant Account field.

2. Copy the Event URL to the clipboard by clicking the (copy) icon, then paste it into your Adyen account.

3. Enable Adyen Test Mode if you are still testing the integration.

Tip

It is possible to let customers add a tip directly on the Adyen card terminal, as well as after payment in a restaurant point of sale.

See also

Payment methods