IMPORTANT NOTE: The Merchant Account is location-specific. It has to be set for every location in the Admin dashboard. Every merchant ID is associated with a different location. On the other side, the API key and Live URL are chain-specific.
Step 1: Adyen Global Payment Type Configuration
For this payment configuration, we want to start with setting up Global values first, because then External ID will need to be set up once on the global level instead of individually for each restaurant location. This part needs to be done in the old dashboard.
To set up Global Payment settings, go to
Menus> Payment Types> Adyen. You will be navigated to the Edit Payment Type page.
The Payment Type and Display Name will already be populated.
Find the External ID value in the chain's configuration workbook, which you'll find under the Lunchbox Payment Type GUID. Alternative names are Payment Type External ID, GUID, or Tender ID.
Once you have Payment Type, Display name, and External ID set, ensure that the Active checkbox is selected and then
Select Save button
Step 2: Creating the Adyen Local Payment Type Configuration
To set up a payment type on a local level,
Go to the Admin dashboard and select Payments
Select a Store Location at the top of the page
Select the Add Payment Configurations button
When the Add Payment Configuration modal appears,
Enter the Description for your Payment Type, it should always be "Credit Card".
As a Payment Type select Adyen from the drop-down list.
You can skip the External ID entry here only needs to be done if the external ID is different for each location
if the Payment type or tender ID is the same across all locations, you can leave the External ID field blank and the Global External ID will take precedence.
Select the Save button to create a New Payment Type.
Configure the Adyen Gateway
Once you add a Payment Type to the chosen location, it's time to enter its details:
Select your Payment Type and ensure that the Description and Payment type are already entered. In the example we created, the Description is Credit Card and the Payment is Adyen.
You can skip External ID if the value is a globally shared ID and skip Gateway account for now. We'll revisit that in the next steps.
Choose Complete Order from the Capture Step dropdown
Select checkboxes next to Visa, Mastercard, Discover, and American Express (This is based on what was configured in the Adyen Dashboard)
Select the Save button to save the settings
After saving the new payment type, it is time to create a Gateway.
Select Edit Gateways. You'll get navigated to the Payments> Gateway page. In here:
Select the Add Gateway button
Enter Description "Adyen Gateway"
Select Adyen Payment Type from the drop-down list
Select the newly created Gateway Account and ensure the Description and Payment Type match with what you previously entered.
Now, you'll need to Edit Gateway and populate the following gateway fields: API Key, Merchant Account, and Adyen Live URL. Here's the instruction.
After setting up Gateway, navigate to Payments and find your Credit Card Payment Type. You are now ready to continue with the Payment configuration:
Select the Gateway Account you created from the dropdown ("Adyen Gateway")
Select Save to save your configuration
IMPORTANT NOTE: After creating the New Payment Type ("Credit Card"), you should update the Service Types well. Select the Credit Card checkbox in each Service Type tab that it needs to be applied to, except for Order Aggregation.
IMPORTANT NOTE: You should never have test credit cards and real credit cards have checkboxes checked (toggles on) at the same time for accepted payment methods..
Uncheck payment methods for Test payment type (Visa, MasterCard, Discover, Amex)
Remove the Test credit card payment type completely from payments,
Remove the test gateway and
Select checkboxes (toggles) under the Credit Card payment type