An integration with Adyen's Terminal API lets you start payments from your cash register system and process these payments through Adyen using our payment terminals.
Here we describe how you can take your Terminal API integration live.
Before you begin
- Make sure you have a live account and a signed contract. For instructions, refer to Get started with Adyen.
Step 1: Set up your Adyen live account
The structure from your test account is not copied over. This means you need to set up a structure for your live account from scratch, using your live Customer Area.
Request the merchant accounts that you need, providing as many details as possible and ensuring you submit the correct documents and links. The usual processing time is around four business days.
- If you require stores in your account structure, wait for confirmation that your live merchant accounts are created and then submit a store request form. The usual processing time is around two business days.
Request merchant accounts
Add one or more merchant accounts.
Add one or more stores to your merchant accounts.
Step 2: Order live payment terminals
Your test terminals are for testing purposes only. They can't process live payments. This means you need to order new terminals from your live Customer Area.
- Order the terminals that are needed in your physical stores.
It usually takes around four business days before your terminals arrive.
Step 4: Prepare your terminals
The configured settings from your test environment are not copied over. This means you need to configure your live terminals and payment features from scratch in your live Customer Area. You can configure settings at the company account level, the merchant account level, the store level, or the terminal level.
In your live Customer Area, enable Terminal API for your terminals.
Add payment methods and configure the terminal and payment features that you want to use. Our POS Support Team will help you with any features that you can't fully configure yourself.
- Assign the live terminals to a store. This makes it easier to start using terminals when you receive them. You can assign terminals from your Customer Area or using our Terminal Management API.
Enable Terminal API
Make your terminals ready to use the Adyen Terminal API.
Add branding and set up payment features.
Prepare your terminals for quicker boarding.
Step 5: Update your integration
Add at least one API credential and optionally add users to your live Customer Area.
For your live account we don't create a default API credential, so you need to create API credentials yourself. For example, a separate API credential for each merchant account, or one for point of sale and one for ecommerce.
You can also create additional users for your team members and assign the roles they need for their tasks.
Update your code:
For a local integration, update your integration to reflect the IP addresses (or resolvable hostnames) of the live terminals, and secure the communication with our live terminal certificate (or use a library). If you skipped encrypting communications in your test integration, you need to implement encryption now.
A live terminal will not accept API requests without encryption.
- For a cloud integration, generate a new API key and switch to the live endpoints and the new API key.
When you receive the terminals, follow the steps in the manual for the terminal model to get the terminals up and running. The steps are to:
- Inspect the terminal, to verify it has not been tampered with.
- Insert the receipt paper roll.
- Turn on the terminal.
- Connect the terminal to your network.
- Board the terminal.
- Test the connection with the Adyen payments platform.
Step 6: Test your integration
To make sure your live integration is working as expected, you should do end-to-end tests from making a payment with a real card to completing your reconciliation.
Make a low-value payment with a real card.
Log in to your live Customer Area and make sure the payment was successful:
- Go to Transactions > Payments and find the payment.
- Click on the payment's PSP reference.
Under History, you should see the JournalTypes transition from:
If the payment reached a JournalType of Settled the payment was successfully processed by the card issuer.
- Refund the payment, to test your refund flow.