Help
Everything you need to connect Adyen, map your e-conomic accounts, run syncs, and troubleshoot errors in Adyen to e-conomic.
Getting started
Install the app from the e-conomic Marketplace. You will be redirected here to finish setup in three steps:
- Connect e-conomic — we use e-conomic's secure grant-token model. Your e-conomic password is never stored.
- Connect Adyen — add your API key and one or more merchant accounts, then configure the Adyen webhook for accounting reports.
- Map accounts — choose your cashbook journal, fee, net, difference (rounding), and optional clearing account.
When setup is complete, the Home dashboard shows a green status banner and you can run your first sync.
Home dashboard
Home is your overview after login. The status banner at the top reflects the current state of your setup and sync:
- All good — last sync completed successfully. Use Process reports when new accounting reports are available.
- Sync in progress — a sync is running. The banner updates automatically while payments are imported.
- Needs attention — failed report downloads or payments that are not yet resolved. Open Sync or Activity with the Needs attention filter.
- e-conomic access lost — reconnect in Settings before syncing again.
- Setup checklist — shown until e-conomic, Adyen, account mapping, and your first report are complete.
When Adyen is connected, the report inbox card shows pending, failed, or ready-to-process accounting reports from webhooks. Below the banner you will see connection status, sync statistics (last 30 days), the next scheduled run (if enabled), and a table of recent sync runs. Click any run to open its detail page.
Connections
e-conomic
The app needs permission to read invoices and create cashbook vouchers in your e-conomic agreement. After you log in, open Settings → Connections.
- Reconnect — use this if e-conomic access was revoked or expired.
- Disconnect — removes the grant token from this app. Uninstalling from the Marketplace also revokes access immediately.
Adyen
In the
Adyen Customer Area,
create a web service API key with access to download accounting reports,
add every merchant account you want to sync (you can add more later in Settings),
and configure a standard webhook pointing to
https://2app-adyen-economic.srv871186895.internet-server.dk/webhooks/adyen
with REPORT_AVAILABLE enabled. Credentials are encrypted after saving.
Accounting mapping
Each synced Adyen settlement line becomes a balanced cashbook voucher in e-conomic:
- Gross — customer payment matched to a booked invoice, or posted to a clearing account when invoice matching is off.
- Fee — card/acquirer fees from the report (markup, scheme, interchange, commission).
- Net — payable amount deposited to your bank (Payable SC in the Adyen report).
- Difference — only when the invoice gross amount does not exactly match the payment gross (rounding).
From the accounting report we import SentForSettle and Refunded rows only. Other lifecycle rows (Authorised, Received, etc.) are ignored. Monthly Adyen processing fees on separate invoice lines are not split into each payment voucher.
Invoice matching mode
Choose how payments without a booked invoice are handled:
- Require booked invoice — matches Adyen Merchant Reference to the e-conomic invoice Other reference field. If your shop does not put the order/invoice id there, use flexible mode instead.
- Allow payments without invoice — unmatched gross amounts post to a clearing account you choose. Useful when not every payment has an invoice yet.
Accounts to map
- Cashbook journal — where vouchers are created.
- Difference account — small rounding when payment gross ≠ invoice gross.
- Fee account — Adyen transaction fees per settlement line.
- Net / bank account — the net settlement amount deposited to your bank.
- Clearing account — only required in flexible invoice mode.
Account numbers depend on your chart of accounts. If you are unsure, ask your accountant before saving.
Sync
Open Sync in the app to process available accounting reports. The app works in two steps:
- Ingest reports — pending Adyen accounting reports (from webhooks or CSV upload) are downloaded; SentForSettle and Refunded rows become settlement lines.
- Post to e-conomic — each payment is turned into a cashbook voucher using your account mapping.
Already-imported payments are skipped automatically — re-running a sync does not create duplicates in e-conomic. You can also upload a CSV manually if a webhook was missed.
Process reports
Click Process reports to download pending reports and post new lines. Date range is optional under Advanced — normal Adyen syncs process whole reports, not a calendar poll.
Scheduled sync
In Settings → Schedule, choose daily or weekly automatic sync and the time of day. The Home dashboard shows when the next run is due.
Activity
The Activity page shows your payment timeline and sync history in one place. Filters and paging update instantly without reloading the whole page.
Filters and search
- All — individual payments plus sync history below.
- Sync history — hide payments and show only the list of sync jobs.
- Needs attention — payments that failed and still need your action.
- Search — type a payment or settlement reference; results update as you type.
Payments
Each row is one payment from a Adyen settlement report. You see the reference, status, time, and settlement batch. Use Payload to inspect raw payment, settlement, and e-conomic voucher data when troubleshooting. Actions appear on failed or synced payments:
- Retry — try again to post this payment to e-conomic (for example after you booked the missing invoice). A short confirmation toast appears when done; the list refreshes automatically.
- Resolve — hide the error when you handled it outside the app (for example, entered the voucher manually in e-conomic).
- Resolve all — available on the Needs attention filter to clear every open error at once.
- Force retry — on already-synced or skipped payments only. Use with care: this may create a duplicate voucher in e-conomic. The app asks you to confirm first.
Sync history
The table at the bottom lists each sync job with scope (all reports or a date filter), trigger (manual, scheduled, or CSV import), and result counts. Click a row to open the sync run page with every payment in that job and a Retry processing option when errors occurred.
The Home banner counts only unresolved errors — successfully retried or manually resolved payments no longer increase the attention count.
Settings
Settings
is organised in tabs on the left (or a dropdown on mobile). Switch tabs without leaving the page; the URL updates so you can bookmark a section (for example ?tab=schedule).
When you save a form, changes are sent in the background and a toast notification confirms success or shows an error.
- Connections
- Connect, reconnect, or disconnect e-conomic and Adyen.
- Accounting
- Invoice matching mode and account mapping.
- Schedule
- Automatic sync frequency and time.
- General
- Company display name and timezone.
- Notifications
- Email alerts when a sync has errors or warnings.
- Security
- Change your login password.
Sidebar tip: use the arrow at the bottom of the left menu to collapse it. Your preference is remembered on this browser.
Troubleshooting
"e-conomic access lost" on Home
Reconnect in Settings → Connections. Make sure you select the same agreement number as before.
Payment failed — no matching invoice
Ensure the e-conomic invoice Other reference equals the Adyen Merchant Reference, then Retry in Activity. Or switch to flexible invoice mode and map a clearing account in Settings → Accounting.
No reports arriving
Copy the webhook URL from Settings → Connections, confirm Adyen sends REPORT_AVAILABLE for accounting reports, and that merchant account codes match. Home shows the report inbox status. You can also upload a CSV on Sync.
Report download failed
Usually the API key cannot download reports. Update the web service key in Settings (needs report download permission), then Process reports again.
Payment gross does not match invoice
Small differences are posted to your Difference account (configured in Settings → Accounting). If the gap is large, check that the booked invoice gross matches the Adyen Main Amount on the SentForSettle row.
Payment failed — e-conomic API error
Open the payment or sync run in Activity and read the error message shown on the line. Common causes: wrong journal, missing voucher number series for the accounting year, or invalid account numbers.
Retry does not fix the problem
Fix the underlying issue in e-conomic or your mapping first, then retry the individual payment. If you already fixed it manually in e-conomic, use Resolve instead of force retry.
Duplicate voucher in e-conomic
This can happen if you used Force retry on a payment that was already synced. Delete or correct the duplicate in e-conomic, then use Resolve on the line in Activity if needed.
Adyen connection test fails
Verify the API key can download accounting reports and has not been revoked. Create a new key in the Customer Area if needed.
Page looks outdated after an action
Activity and Settings refresh their content automatically after retry, resolve, or save. If something still looks wrong, hard-refresh the browser (Cmd+Shift+R on Mac, Ctrl+Shift+R on Windows).
Forgot your password?
Use Forgot password? on the login page.
Still need help?
Email us at info@2app.dk — we normally reply within 24 hours. See also our Support page.