Skip to main content

How to onboard on Adyen?

Connect your Adyen account to orderBilly so you can accept online and terminal payments.

You need an Adyen-account before you're able to receiving payments through orderBilly.

This integration works for both online payments as terminal payments

1) Setting up the Adyen integration.

1) Login to my.orderbilly.com

2) Go to Payment Methods > Adyen

(Reach out to your account manager if you don't see the 'Adyen' option)

For both online and terminal payments:

3) Fill in 'API Key', 'Merchant ID', 'Live URL prefix'

For terminal payments:

4) Fill in 'HMAC secret'

Optionally:

5) 'Theme ID'

2) Where to find these credentials?

API Key

1) Login to your Adyen Customer Area (ca-live.adyen.com)

2) Go to Developers > API credentials

3) Create new Credential

4) Now you have an API key. Keep it secure. Make sure you copy-paste the key since you can only see it once. Paste into Billy

Merchant ID

1) Login to your Adyen Customer Area (ca-live.adyen.com)
2) Go to Account > Merchant accounts

3) Copy-paste your Merchant ID into Billy.

Prefix

1) Login to your Adyen Customer Area (ca-live.adyen.com)

2) Go to Developers > API URLs

3) Create an API URL or copy-paste the Prefix into Billy.

The prefix now get checked if it has the right format, and will give an error message when it's is not correct.

HMAC Secret (webhooks)

For accepting POS payments you need to setup a webhook with HMAC secret.

1) Login to your Adyen Customer Area (ca-live.adyen.com)

2) Go to Developers > Webhooks

3) Create a Standard webhook with Server URL: https://api.orderbilly.com/api/callbacks/adyen
4) No authentication needed

5) Now you can find the HMAC Secret. Keep it secure. Make sure you copy-paste the secret since you can only see it once. Paste into Billy

6) Make sure you mark at least the events 'AUTHORISATION' and 'CANCELLATION'

3) Test the integration for online payments.

Test the ordering flow and try to make a payment.

4) Test the integration for POS terminals.

1) Go to my.orderbilly.com

2) Go to Payment Methods > Adyen > Terminals

3) Click sync and refresh the page

4) Edit the terminal and link it to your desired kiosk device

5) Test the kiosk payment flow.

Did this answer your question?