Connecting an Adyen payment terminal allows you to offer a fluid payment flow to your customers and ease the work of your cashiers.
Adyen works only with businesses processing more than 10 million annually or invoicing a minimum of 1,000 transactions per month.
Start by creating your Adyen account on Adyen’s website. Then, board your terminal following the steps described on your terminal’s screen.
Configure the payment method¶
First, go to Adyen. Then, go to and create a new payment method. Select Adyen in the Use a Payment Terminal field., and enable
The selected journal must be a bank journal for the Use a payment terminal field to appear.
Finally, fill the mandatory fields with an Adyen API key, and an Adyen Terminal Identifier.
Generate an Adyen API key¶
The Adyen API key is a key used to authenticate your requests. To generate an API key, go to your Adyen account.
Then, go to. Create a new credential or click on an existing one.
Click on Generate an API key and copy-paste that key onto the CoquiAPPs mandatory field.
Locate the Adyen terminal identifier¶
The Adyen Terminal Identifier is your terminal’s serial number, which is used to identify the hardware.
To find this number, go to your Adyen account. Then, go to, select the terminal to link, and copy-paste its serial number onto the CoquiAPPs mandatory field.
Set the Event URLs¶
For CoquiAPPs to know when a payment is made, you must set the terminal Event URLs. To do so,
log in to Adyen’s website;
go toand select the connected terminal;
from the terminal settings, click Integrations;
set the Switch to decrypted mode to edit this setting field as Decrypted;
click the pencil icon button and enter your server address, followed by
/pos_adyen/notificationin the Event URLs field; and
click Save at the bottom of the screen to save the changes.
Add a new payment method¶
To add a new payment method to a point of sale, go to. Then, select the POS and go to , and add your new method for Adyen.
Pay with a payment terminal¶
When processing a payment, select Adyen as the payment method. Check the amount and click on Send. Once the payment is successful, the status changes to Payment Successful.
- In case of connection issues between CoquiAPPs and the payment terminal, force the payment by clicking on Force Done, which allows you to validate the order.This option is only available after receiving an error message informing you that the connection failed.
To cancel the payment request, click on cancel.