Plugin icon

Set up in-person payments

Use our Adobe Commerce plugin to process in-person payments with our terminal API. 

This page describes the in-person payments setup for v9.0.1 or later. If you are using an earlier version, see the older documentation.

Our plugin for Adobe Commerce allows you to process both online and in-person payments, offering a consistent shopper experience regardless of their location or device. You can manage all orders in the Adobe Commerce admin panel, and get a detailed insight into your shopper behavior in the Adyen Customer Area.

For an overview of supported payment terminals, refer to Select your terminals.

Before you begin

Set up a separate merchant account for processing in-person payments. For more information about Adyen account structure, refer to Company and merchant accounts.

Step 1: Generate an API key

For authenticating API requests from your Adobe Commerce platform, you need to provide an API key.

To generate an API Key:

  1. Log in to your Customer Area.
  2. Go to Developers > API credentials, and select the API credential username for your integration, for example ws@Company.[YourCompanyAccount].
  3. Under Server settings > Authentication select the API key tab.
  4. Select Generate API key.
  5. Select the copy icon and store your API key securely in your system.
  6. Select Save changes.

You will need the API key later when configuring the plugin in Adobe Commerce.

Before going live, make sure that your API credential has the Merchant PAL webservice role. If you need to enable this role, contact our Support Team.

Step 2: Set up capture delay

For all cards, in-person payments are completed in two steps: 

  1. Authorisation – The payment details of the shopper are verified and the funds are reserved.
  2. Capture –  The reserved funds are transferred from the shopper to your account. 

For payment methods that support separate authorisation and capture, you can specify a delay between authorisation and capture. This allows you to handle cases where the shopper changes their mind about the purchase.

The capture delay setting does not affect Alipay, WeChatPay, and some other wallets, as these payment methods are always completed in one step.

Set up capture delay in the Adyen Customer Area

  1. Log in to the test Customer Area with your merchant account.

  2. Go to Settings > Account settings.

  3. On the POS Capture Delay drop-down menu, select the capture delay that you want to use. 

  4. Possible values:

    • immediate: Capture is performed immediately after authorisation.

    • [N] minutes/hours/days: Capture is performed [N] minutes/hours/days after authorisation. 

      We recommend that you set a capture delay of 2 hours, for cases where the shopper changes their mind about the purchase. 

    • manual: You need to capture each payment manually by creating an invoice in Adobe Commerce. This is useful if you wish to perform a partial capture in case some goods can not be delivered to the shopper.

      When you capture a part of the authorised amount, the rest of the authorised amount is automatically cancelled.

  5. Click Submit.

Step 3: Set up the terminal configuration

User roles

For account configuration, you need to have the Merchant POS Terminal Management Admin role. For more information, refer to User roles.

  1. Log in to the  test Customer Area with your company account.
  2. Go to In-person payments > Terminals.
  3. In the actions menu next to the search box, select Account configuration.
  4. Click the Terminal API tab.
  5. Set Enable Terminal API to Yes.
  6. Set Enable WebSockets to Yes.

Step 4: Set up the plugin in Adobe Commerce

  1. Log in to your Adobe Commerce admin panel. 
  2. In the left navigation bar, go to Stores > Configuration. 
  3. On the menu, go to Sales > Payment Methods.
  4. Select Configure next to Adyen Payments.
  5. Go to the In-person payments section, and fill out the following fields: 
Field Description
Enabled Select Yes to enable this payment method.
Title The title that indicates the POS payment method during checkout.
Sort Order The position of the POS payment method during checkout. 
Merchant Account for POS terminal Name of your Adyen merchant account that is used to process POS payments.
Terminal Store ID (Optional) Limit the terminal selection to a specific store in that merchant account.
API key for TEST Your API key from the test Customer Area.
API key for LIVE Your API key from the live Customer Area.
Capture Delay The capture delay that you set in the Customer Area.
Enable Installments Select Yes to enable installments for credit card payments.
Order Creation Time The order creation time after the shopper selects Place order. Set to After payment by default. If you want orders to be created before a payment request is initiated, set to Before payment.
  1. Select Save Config in the upper right corner.

Step 5 (optional): Set up recurring payments

To set up recurring payments:

  1. Log in to your Adobe Commerce admin panel, and go to Stores > Configuration.
  2. In the menu, go to Sales > Payment Methods.
  3. Select Configure next to Adyen Payments.
  4. Go to Payment Optimization > Tokenization and fill in the following fields for the In-person payments field:
Field Description
Payment method In-person payments
Enable Select Yes to enable tokenization for in-person payments.
Recurring Processing Model Set to CardOnFile, UnscheduledCardOnFile, or Subscription depending on how you want to use tokenization.
  1. Select Save Config in the upper right corner.

See also