Adyen

Follow

 

1. Configuration of your Adyen account

Contact Adyen to activate all payment methods you need. billwerk supports credit card payments and SEPA direct debit payments.

Step 1

In your Adyen account, set the Capture delay to manual:

1. Switch from the company account to the merchant account on the top-right. 

2. Click on Account in the left-hand side to open the Account menu.

3. Select Merchant Settings.

4. In the Capture Delay section, click on the drop-down menu and select manual.

5. Click on the Submit button. 

Capture_delay.png

Step 2

Activate recurring tokens:

1. In the Account menu on the left-hand side, select Checkout settings.

2. In the Recurring section, activate the recurring tokens by moving the toggle button to the right.

enableRecurring.png

 

Step 3 (only for live mode)

Contact the Adyen support to generate an endpoint for live payment transactions for you. If Adyen has already generated the endpoint, you can view it:

1. Click on Account in the left-hand side pane to open the Account menu.

2. Select API URLs

Note:

If you want to use Adyen for SEPA Direct Debit payments, the configuration of your Adyen merchant account must be changed to Auth flow. This configuration can only be facilitated by Adyen. Please contact the Adyen support to change the configuration. 

2. Configuration in billwerk and Adyen

To facilitate the settings of the payment service provider in your billwerk account:

1. Click on the Profile icon in the top right corner to open the Settings menu.

2. Select Settings.

3. On the Settings page, choose Payment Settings from the left-hand side pane.

4. Select Adyen. 

Adyen.png

 

Enter the name of your Adyen merchant account as it appears in the Adyen user interface. 

The merchant account is marked in red in the following screenshot:

H_ndlerkontoname.png

 

Recurring details:

To activate recurring payments, go to Developers > Additional Data and activate under Payment the checkbox Recurring details.

 

API Key

Generate a new API key in Adyen and paste it in billwerk:

1. In your Adyen merchant account, select Account from the left-hand side menu. 

2. Click on API Credentials.

3. Select the user ws@[your company name].

4. In the Authentication section, click on Generate New API Key

5. Paste the generated key in billwerk.

6. Finish this step in Adyen by pressing Save Generated API Key

To copy the library location from Ayden to billwerk:

1. In your Adyen merchant account, select Account from the left-hand side menu. 

2. Click on Users.

3. Select the user ws@[your company name].

4. In the Client-Site Encryption section, copy the Library location link.

5. Paste the link in billwerk.

You have to activate the Standard Notifications in Adyen for the HMAC key:

1. In your Adyen merchant account, select Developers from the left-hand side menu. 

2. Choose Webhooks.

3. Click on the + button to add Standard Notifications and to open a dialog box.

4. In your billwerk account, click on the Profile icon in the top-right corner to open the Settings menu.

5. Select Settings.

6. On the Settings page, choose Payment Settings from the left-hand side pane.

7. Click on the Edit icon by Adyen.

8. Copy the link from the Adyen Account Requirements box on the Settings Adyen page.

9. In Adyen, paste the URL into the URL field in the Transport section.

Standard_notification.png

10. Click on Additional Settings.

11. Select the Generate new HMAC key  button in the HMAC Key (HEX Encoded) section.

12. Copy the HMAC key. 

12. In billwerk, paste the HMAC key into the HMAC Key field.

13. In Adyen, click on Save Configuration at the bottom of the page.

14. Activate the following notifications:

  • Authorisation
  • Chargeback_Reversed
  • Report_Available

Test_Notification.png

15. Activate the Standard notification.

Standard_notification_aktivieren.png

After configuring the notifications, you must now also subscribe to "Payment accounting":

1. Select Reports from the left-hand side menu. 

2. In the Payment Accounting accounting section, ensure that Automatic generation is enabled with .CSV as report type. 

Payment_accounting.png

 

Reporting User Name and Password

A separate Adyen Reporting user is required to call up the reports:

1. Select Accounts from the left-hand side menu. 

2. Go to API Credentials.

3. Click on Add new credential  and select Report user as the user type.

mceclip2.png

A user name and password will be created automatically.

4. You can then transfer both to the billwerk payment settings.

Report_User_Credentials__2_.png

Make sure that Merchant Report Download role is selected.

Merchant_report_download_role__2_.png

Live Endpoint

In Live Mode, the Live Endpoint generated in chapter 1, step 3 must be stored. 

3. Test data

Credit Card

Visa

Card Number 4035501000000008
Expiry Date 03/2030
CVC 737

Mastercard

Card Number 2223000048410010
Expiry Date 03/2030
CVC 737

Discover

Card Number 6445644564456445
Expiry Date 03/2030
CVC 737

Diners Club

Card Number 36070500001020
Expiry Date 03/2030
CVC 737

American Express

Card Number 370000000000002
Expiry Date 03/2030
CVC 7373

Cartes Bancaires

Card Number 4035501000000008
Expiry Date 03/2030
CVC 737

 

SEPA Direct Debit

IBAN Account Holder
DE87123456781234567890   A. Schneider
DE92123456789876543210 B. Schneider
DE14123456780023456789 C. Schneider

 

If you are looking for additional test data you can find the full list under this link

4. Limitations

  • Adyen supports only Euro as currency for SEPA direct debits
  • If you integrate iDeal through Ayden, the limitations are:
    • Preauthorization transactions are not possible
    • Signup with trialplans (0€ amount) is not supported
    • Order approval is not supported
    • Signup with ExternalCustomerID is not supported unless the customer is created first and then the contract
    • PaymentChange will trigger a 0,01€ payment, even if balance is 0€ 
Was this article helpful?
1 out of 1 found this helpful