RO Payments

Configure payment provider Adyen

This document explains how to configure payment provider Adyen.

Prerequisites

To configure Adyen the following details are required:

  • Merchant Key
  • API Key
  • Live URL Prefix (only used in production)
  • Webhook HMAC
  • Description

Make sure you have selected your merchant account in Adyen from the top left corner menu.

Adyen profile selector

Test mode

You can enable the profile to be used in test mode or not. In test mode a Live URL Prefix is not used and can be left empty.

Merchant Key

The Merchant Key is the name of your merchant account. 

  1. Click on Developers in the left side menu
  2. Click on API Credentials
  3. The Merchant Key is in the column Accounts
  4. Copy the name and paste it into the Merchant Key field

API Key

The API Key can be found on the API Credentials page as well.

  1. Click on Developers in the left side menu
  2. Click on API Credentials
  3. Click on the Username
  4. This opens the Configure API credential page
  5. Go to the second block that is called Server settings
  6. Either copy an existing API key from there or generate a new API key and copy the new key
  7. Paste the key into the API Key field

Live URL Prefix

To be able to use the Adyen profile in a live environment, you can skip this when you are still testing, you need to set a Live URL Prefix.

  1. Click on Developers in the left side menu
  2. Click on API URLs
  3. Copy your Live URL prefix from here
  4. Paste the Live URL prefix into the Live URL Prefix field

Webhook HMAC

The webhook HMAC is needed to be able to process any webhooks send from Adyen to the website and update payment statuses. First step is to create a webhook. Webhook should be changed at company level, so switch to the company first before creating the webhook.

  1. Click on Developers in the left side menu
  2. Click on Webhooks
  3. Click on Create new webhook
  4. Select Standard webhook
  5. Enter the General settings
  6. Enter a descriptive name for your webhook
  7. Select the appropriate merchant accounts that can use this webhook
  8. Enter the Server configuration settings
  9. The URL must be https://YOUR_DOMAIN/notify, replace YOUR_DOMAIN with the domain name where the website runs
  10. Set Method to JSON
  11. Set Encryption protocol to TLSv1.3
  12. Enter the Security settings
  13. The Basic Authentication is not used
  14. Generate a new HMAC ID
  15. Copy the HMAC ID
  16. Paste the HMAC ID into the Webhook HMAC field. After you save the configuration, the webhook HMAC will no longer be shown. In case you lost it, you will need to generate a new HAMC key.
  17. Enter the Events settings
  18. Select the following events:
    1. AUTHORISATION
    2. CANCELLATION
    3. EXPIRE
    4. PENDING
  19. The rest does not need to be filled out
  20. Save your configuration

Description

A description is required to be able to make a payment. The description will help customers identify their payment.

Order Numbers

You can choose which number is used as order number, by default RO Payments uses the order number but you can change this to be the order ID. 

Related Articles