🚀 We have moved! A new docs experience awaits you!. User docs on this site will not be updated anymore, and completely deprecated on 1 April, 2025.
Tutorial: Setting up Adyen in a store
The aim of this tutorial is to set up Adyen as a
payment service provider in a store based in New York City for an
imaginary business that has the following characteristics:
One store located in New York City, whose fulfillment_node_id is store1_NYC.
One payment terminal from Adyen that supports Adyen Terminal API.
For this tutorial, we will use the e285 device.
note
Before getting started with this tutorial, ensure that you have:
This tutorial is based on the Adyen Terminal API, as
it is the recommended method to connect Adyen payment devices to the NewStore platform.
Important
This tutorial depends on Adyen setup functionalities. If Adyen changes
the setup process, it may take some time for these changes to reflect in
this tutorial.
Before you start working with the Adyen payment device to process
payments in the store via NewStore, follow this procedure to ensure
Adyen can process payments.
Test payment devices cannot process live payments. Ensure that you
have ordered live payment terminals at least 1 week before you want
to start processing payments in your store via Adyen.
In our case, from the Point of sale section in the Adyen Customer Area, assign the terminal NYC_1 to
the store store1_NYC.
note
Terminals recently ordered, but not assigned yet, are listed under
the Inventory area in the same page. You can also reassign
terminals from one store to another if needed.
To test the integration
with the terminal, make a low-value (USD 1) payment on the NYC_1 terminal in the store.
In the Adyen Customer Area, verify
that the PSP reference history for the payment shows the following
transition: Received > Authorised > Settled.
(Optional) Refund the payment to validate the refund process.
You have now successfully set up the NYC_1 payment terminal in the New
York City store.
Next, we will ensure that the device works with the NewStore platform.
Setting up NewStore to process payments via Adyen​
To set up NewStore to process payments via Adyen, follow these steps to
validate that NewStore Associate App can use the NYC_1 Adyen payment
terminal you have set up for your New York City store.
Install NewStore Associate App.
Ensure that you are assigned to the store1_NYC store via NewStore
Omnichannel Manager. See Managing users and roles in NewStore
Omnichannel Manager.
Connect the terminal and NewStore Associate App to the same Wi-Fi
network in the store.
To view the assigned payment terminal in the store, in NewStore
Associate App, tap
> Credit Card Terminal.
The terminal NYC_1 appears in the list.
During checkout, select Credit Card and select NYC_1 as the
terminal, and tap Connect to Terminal.
Adyen is now set up in your New york City store and you can use NYC_1
(the e285 device) to process payments.