Overview
Adyen is a payment provider connector in Junipeer. It enables automated payout reconciliation — matching Adyen settlement reports to invoices in your ERP so that invoices are marked as paid and processing fees are tracked automatically.
Adyen connects to Junipeer via webhooks. Unlike e-commerce or ERP connectors that sync on a schedule, Adyen sends payout and settlement data to Junipeer when reports are ready.
What Adyen provides
When connected, Adyen sends Junipeer:
Payout/settlement reports — details of which transactions are included in each bank deposit
Transaction-level data — individual payment amounts, fees, and references that Junipeer uses to match against invoices in your ERP
This data powers the payment reconciliation flow described in the Order Sync guide.
Prerequisites
Before setting up Adyen in Junipeer, you need:
An active Adyen merchant account with access to the Adyen Merchant Portal (Customer Area)
The payout/settlement reports enabled for your merchant account
Webhook access permissions in the Adyen portal
Step 1 — Enable required reports
Adyen needs to generate the reports that Junipeer will consume.
Log in to the Adyen Customer Area (Merchant Portal)
Navigate to the reports configuration section
Enable the Settlement detail report — this contains the transaction-level detail Junipeer needs for matching
Verify that report scheduling is active so reports are generated automatically after each settlement
If you are unsure which reports are available or enabled, check with your Adyen account manager.
Step 2 — Configure the webhook
Junipeer receives Adyen data via a webhook. You need to create a webhook in the Adyen portal that points to Junipeer's endpoint.
In the Adyen Customer Area, go to Developers → Webhooks
Click + Webhook to add a new webhook
Set the URL to the Junipeer webhook endpoint provided during onboarding (visible on the Webhooks page in Junipeer)
Select the relevant event types — at minimum, enable events related to payout reports and settlement details
Save the webhook configuration
After saving, Adyen will start sending event notifications to Junipeer whenever a settlement report is generated.
Step 3 — Connect in Junipeer
In Junipeer, navigate to the Connectors page for your integration
Enter the Adyen credentials or configure the connection as prompted
Verify the connector shows a green "Connected" status
Go to the Webhooks page and confirm Adyen events are listed
How it works in practice
Once connected, the typical flow is:
Customers pay via Adyen in your e-commerce store
Junipeer syncs those orders to your ERP, creating invoices with reference numbers
Adyen settles the transactions and generates a report
The report is sent to Junipeer via the webhook
Junipeer matches each transaction to the corresponding ERP invoice
Matched invoices are marked as paid; processing fees are booked to your fee account
This process runs automatically. You can monitor it on the Tasks and Logs pages.
For troubleshooting common errors, see the Error Codes reference or your connector pair's troubleshooting section.
Tips
Set up Adyen after your order sync flow is working correctly. Payout reconciliation depends on invoices already being created in the ERP with proper references.
Test with a small settlement period to verify matching works before relying on it for all payouts.
If you use multiple Adyen merchant accounts (e.g., for different stores or regions), each one needs its own webhook configuration pointing to the correct Junipeer integration.