1. Configuration of your Adyen account
Contact Adyen to activate all payment methods you need. billwerk supports credit card payments, SEPA direct debit payments and iDeal.
Note: If you already have an Adyen account and want to update your settings to use new Adyen integration, check directly the Client key section.
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.
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.
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.
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:
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.
Client key
Adyen API for CreditCards requires Client Key to be saved in billwerk. This step is required for merchants who want to switch from old Adyen Credit Card implementation to a new one:
1. Generate a new Client key in Adyen account for your user and copy it
2. Paste the key into the "Client key section" on Adyen settings in billwerk.
Every input for entering card sensitive data is hosted on Adyen side and present as iFrame on the page. If you are using your own sign up page, please note, we are not loading new Adyen js library automatically as for other psps, because additional objects should be created client side. The instructions and detailed description you can find here.
If you are using our hosted pages, no additional changes needed.
Note: this parameter is being used by merchants who are using previous Adyen integration.
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.
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
15. Activate the Standard notification.
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.
Reporting User Name and Password
A separate Adyen Reporting user is required to call up the reports:
1. Select Developers from the left-hand side menu.
2. Go to API Credentials.
3. Click on Create credential and select Report user as the user type.
A user name and password will be created automatically.
4. You can then transfer both to the billwerk payment settings (username and password).
Make sure that Merchant Report Download role is selected.
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€