Processing Cash Receipt Journals for Adyen Payouts

In this article, we walk through how to process cash receipt journals for Adyen payouts in TAPP Adyen for Dynamics 365 Business Central. This process reconciles your Adyen settlement files with Business Central by creating and posting the appropriate journal entries for each payout batch.

📝 Note: Before you can process cash receipt journals, your Adyen payout settlement files must already be imported into Business Central. Each row in the Adyen Payouts list represents a single settlement batch file from your Adyen merchant account.

Overview

The Adyen Payouts page is the central hub for managing your Adyen settlement data in Business Central. From here you can review payout lines, create journals, and post them — all in one place. Each payout header corresponds to a settlement detail report (CSV) received from Adyen, grouped by merchant and settlement date.

Settlement detail reports are imported into Business Central automatically. Adyen generates these reports on a scheduled basis and TAPP Adyen retrieves them without any manual intervention, provided the environment has been correctly configured with a reporting user credential (see Prerequisites below).

Once imported, the workflow follows a simple two-stage process:

• Create the Cash Receipt Journal from the payout data.
• Post the journal to update your General Ledger and Customer Ledger.

Prerequisites

Before settlement files can be imported automatically, two configuration steps must be completed on your environment. These are typically performed once during initial setup by your system administrator.

1. Create a Reporting User in Adyen

A dedicated reporting user must be created in your Adyen Customer Area. This user account is used exclusively by TAPP Adyen to authenticate and retrieve settlement detail reports.

1. Log in to your Adyen Customer Area and navigate to Settings > Users.
2. Create a new Report User. Take note of the Username and generate an API Key for this user — both values are needed in the next step.
3. Ensure the report user has permission to access settlement detail reports for the relevant merchant account(s).

📝 Note: The report user is a system-level credential and should not be used for day-to-day Adyen Customer Area access. Store the API key securely — it cannot be retrieved after initial generation.

2. Configure the Reporting Credentials in TAPP Adyen Parameters

Once the reporting user has been created in Adyen, the credentials must be entered in the TAPP Adyen parameters in Business Central.

• Use the Search function (Alt + Q) and search for Adyen Parameters, then open the page.
• Navigate to the Payouts / Settlements section.
• Enter the reporting user credentials in the following fields:

Field / Toggle	Description
Report Username	The username of the reporting user created in the Adyen Customer Area.
Report User API Key	The API key generated for the reporting user. This is used to authenticate the automated settlement report retrieval.

• Save the parameters. TAPP Adyen will now use these credentials to automatically retrieve settlement detail reports from Adyen on a scheduled basis.

💡 Tip: If settlement files are not appearing in the Adyen Payouts list, verify that the Report Username and Report User API Key are correctly entered and that the reporting user has the appropriate permissions in the Adyen Customer Area.

Navigating to Adyen Payouts

• Open Dynamics 365 Business Central.
• Use the Search function (Alt + Q) and type Adyen Payouts, then select the page from the results.

The Adyen Payouts list will open, showing all imported settlement files grouped by Adyen merchant.

Understanding the Adyen Payouts Page

Status Toggles

Across the top of the page, a row of read-only toggle indicators shows the processing state for each payout. These are automatically updated as you complete each stage of the workflow:

Field / Toggle	Description
Cash Receipt Jnl. Created	Indicates that a Cash Receipt Journal has been created for this payout.
Cash Receipt Jnl. Posted	Indicates that the Cash Receipt Journal has been successfully posted.
Purch. Journal Created	Indicates that a Purchase Journal has been created (used for scheme fees and processing costs).
Purch. Journal Posted	Indicates that the Purchase Journal has been posted.
Payment Jnl. Created	Indicates that a Payment Journal has been created.
Payment Jnl. Posted	Indicates that the Payment Journal has been posted.
Refund Created	Indicates that a refund entry has been created for this payout.
Refund Posted	Indicates that the refund entry has been posted.
Chargeback Created	Indicates that a chargeback entry has been created.
Chargeback Posted	Indicates that the chargeback entry has been posted.

💡 Tip: Use these toggles at a glance to see which stages are complete and which still require action. A blue (enabled) toggle means that stage is done.

Payout Header List

The main grid lists your imported settlement files. The key columns are:

Field / Toggle	Description
Adyen Merchant	The Adyen merchant account that generated this settlement.
Settlement PSP Reference	The unique reference for the settlement file, matching the CSV filename from Adyen (e.g. settlement_detail_report_2026-04-17.csv).
Settlement Date	The date the settlement was processed by Adyen.
Currency	The settlement currency (e.g. EUR).
Vendor Invoice Id	The vendor invoice reference, populated once a purchase journal has been created.
Vendor Invoice Date	The date of the associated vendor invoice.

Payout Lines

Selecting a payout header in the top grid will load the associated Payout Lines in the lower panel. Each line represents an individual transaction within the settlement batch. Key columns include:

Field / Toggle	Description
Settlement PSP Reference	Links the line back to its parent settlement file.
Payout Line No.	Sequential line number within the payout batch.
PSP Reference	The unique Adyen payment reference for this individual transaction.
Type	The transaction type (e.g. Settled, Refunded, Chargeback).
No. Of Invoices	The number of Business Central invoices matched to this transaction.
Gross Credit / Gross Debit	The gross amounts credited or debited for the transaction.
Gross Currency	The currency of the gross amounts.
Net Credit / Net Debit	The net amounts after Adyen fees.
Net Currency	The currency of the net amounts.
Scheme Fees	The card scheme fees charged by Adyen for this transaction.

Processing a Cash Receipt Journal

Step 1 — Select the Payout

1. In the Adyen Payouts list, click the Cash Receipts tab in the action bar to filter the view to payouts relevant to cash receipt processing.
2. Click on the payout row you want to process to select it. Verify the Settlement Date and Adyen Merchant are correct before proceeding.

Step 2 — Create the Cash Receipt Journal

1. With the correct payout selected, click Create Cash Receipt Journal in the action bar.

TAPP Adyen will process the payout lines and generate a Cash Receipt Journal in Business Central. Once complete, the Cash Receipt Jnl. Created toggle at the top of the page will switch to enabled (blue).

📝 Note: The journal is created using the posting setup configured in the TAPP Adyen parameters. Ensure your G/L accounts and journal templates are correctly configured before running this step. Contact your system administrator if you are unsure of the correct setup.

Step 3 — Review the Journal

1. With the payout selected, click the View tab in the action bar, then click View Receipts. This opens the Cash Receipt Journal so you can review the generated lines before posting.
2. Verify that each journal line reflects the correct amounts, accounts, and document references from the payout lines.
3. Pay particular attention to the No. Of Invoices column on the payout lines — any line showing 0 matched invoices may indicate an unmatched transaction that requires investigation before posting.

💡 Tip: Lines with 0 matched invoices are not necessarily errors — they may relate to fees, adjustments, or transactions processed outside Business Central. Always confirm with your finance team before posting.

📝 Note: The View Receipts action is context-sensitive. Before the journal is posted, it opens the Cash Receipt Journal for review. Once the journal has been posted, the same action will instead open the related G/L Register, allowing you to verify the posted entries.

Step 4 — Post the Cash Receipt Journal

1. Once satisfied with the journal, return to the Adyen Payouts page and click Post Cash Receipt Journal from the action bar.

Alternatively, you can post directly from within the Cash Receipt Journal page using the standard Business Central Post action.

When posting is successful, the Cash Receipt Jnl. Posted toggle will switch to enabled. The corresponding customer ledger entries and G/L entries will be created in Business Central.

📝 Note: Once a journal is posted it cannot be unposted. If corrections are needed after posting, a reversal or correcting journal entry must be created manually.

Additional Journal Types

Depending on your payout content, you may also need to process additional journal types from the same Adyen Payouts page. These follow the same create-then-post pattern as the Cash Receipt Journal:

Field / Toggle	Description
Purchases	Creates a Purchase Journal for Adyen scheme fees and processing charges. Use the Purchases tab to access this workflow.
Payments	Creates a Payment Journal for net settlement amounts transferred to your bank. Use the Payments tab.
Refunds	Creates refund entries for any refunded transactions within the settlement. Use the Refunds tab.
Chargebacks	Creates chargeback entries for disputed transactions. Use the Chargebacks tab.

💡 Tip: Each tab in the action bar (Cash Receipts, Purchases, Payments, Refunds, Chargebacks) filters the payout list to show only the records relevant to that journal type, making it easy to work through each type independently.

Related Articles

• Issue a Refund for an Adyen Payment
• Cancel an Adyen Payment Request
• Generate an Adyen Payment Request
• Merchant Onboarding
• Parameters