TAPP GoCardless – Automated Payout Processing

Overview

Automated Payout Processing in TAPP GoCardless creates and posts cash receipt and refund journal lines for GoCardless payouts in Business Central.

The process runs through a scheduled job queue and uses separate automation settings for each merchant. You can automate journal creation while retaining manual review before posting, or enable both creation and posting.

Payout processing statuses record which steps have been completed. If processing fails for an individual payout, the system logs the error and continues processing the remaining eligible payouts.

Business Value

Automated payout processing reduces the manual work required to create and post journals for GoCardless settlements.

Merchant-specific settings allow different levels of automation within the same company. Finance teams can retain a review step where required while fully automating processing for other merchants.

Errors are recorded against the affected payout, allowing users to investigate exceptions without preventing other payouts from being processed.

Configure Automated Payout Processing

Open GoCardless Parameters and select Automated Payout Processing to access the payout processing setup.

Create a record for each merchant you want to configure, select the GCL Merchant, and review the following options.

Field	Description
Cash Receipt Creation	Automatically creates cash receipt journal lines for eligible payouts.
Cash Receipt Posting	Automatically posts cash receipt journal lines that have already been created.
Refund Creation	Automatically creates refund journal lines for payouts containing refund transactions.
Refund Posting	Automatically posts refund journal lines that have already been created.

Each merchant has an independent configuration. Changing the settings for one merchant does not affect other merchants in the same Business Central company.

Enable creation without posting if journal lines need to be reviewed manually. Enable both options for automatic creation and posting of the relevant journal type.

If all four options are disabled, no automated processing is performed for that merchant. Disabled processing options do not generate errors.

Schedule the Job Queue

Use Job Queue Entries to schedule the automated payout processing job.

1. Open Job Queue Entries.
2. Locate the entry with Object ID to Run set to 71083026 and description BFTGCLAutoPayoutProcessing.
3. Configure the required recurrence and start time.
4. Set the job queue entry to Ready.
5. Confirm that the next scheduled run date and time are correct.

Important: Schedule the automatic payout creation and posting job queue after the data reconciliation job queues. Allow sufficient time for data reconciliation to complete so that payout processing uses the latest reconciled data.

The processing sequence should be:

1. Run data reconciliation.
2. Allow reconciliation to complete.
3. Run automated payout creation and posting.

Each payout processing run evaluates the configured merchants and performs the processing steps enabled for each one.

Cash Receipt Processing

Journal Creation

When Cash Receipt Creation is enabled, the system creates cash receipt journal lines for payouts where Cash Receipt Created is not yet set.

After successful creation, the payout is updated to show that cash receipt creation is complete.

Payouts already marked as Cash Receipt Created are skipped during creation. Running the job again does not create duplicate cash receipt lines for those payouts or change their existing lines.

Journal Posting

When Cash Receipt Posting is enabled, the system posts cash receipt journals that have been created and are awaiting posting.

Successful posting creates the relevant ledger entries and updates the payout to show that cash receipt posting is complete.

If posting is disabled, the created lines remain in the cash receipt journal for review and manual posting.

Note: Enabling posting does not create missing journals. A payout without a created cash receipt journal is skipped during the posting step without generating an error.

Refund Processing

When Refund Creation is enabled, payouts containing GoCardless refund transactions generate refund lines in the cash receipt journal. The payout is updated when refund creation is complete.

When Refund Posting is enabled, existing refund journal lines are posted and the payout is updated to show that refund posting is complete.

Refund settings operate separately from cash receipt settings. Disabling refund creation does not prevent cash receipt processing from running when its options are enabled.

Monitor Processing Results

After a scheduled run, use the GCL Payout list to review the creation and posting statuses of the relevant payouts.

Created but unposted lines can be reviewed in the Cash Receipt Journal. Successfully posted transactions can be checked in the relevant customer and general ledger entries.

Use the GCL Error Log to investigate unsuccessful processing. Each error identifies the affected payout and describes the issue.

A successful run does not create new error log entries.

Error Handling

An error affecting one payout does not stop other eligible payouts from being processed. This applies to cash receipt creation, cash receipt posting, and refund creation or posting.

If cash receipt creation fails, any partially created lines for that failed payout are cleaned up.

To investigate an exception:

1. Open the GCL Error Log and locate the payout.
2. Review the error description.
3. Correct the underlying data or configuration issue.
4. Review the payout’s processing status and any related journal lines before running processing again.

For example, cash receipt creation may fail when required configuration is missing or when the payout date is earlier than the date of an invoice included in the payout.

Troubleshooting

Issue	What to check
No journals are created for a merchant	Confirm that the merchant has a setup record, the relevant creation option is enabled, and eligible payouts exist. Check that data reconciliation completed before payout processing ran.
Journal lines are created but remain unposted	Check whether Cash Receipt Posting or Refund Posting is enabled, as applicable. Review the GCL Error Log for posting failures.
Posting is enabled but a payout is not posted	Confirm that its journal has already been created. Posting alone does not create journal lines.
Refund lines are not created	Confirm that the payout contains refund transactions and Refund Creation is enabled for the merchant.
Some payouts complete while others remain unprocessed	Review the GCL Error Log for the affected payouts. Individual failures do not stop the remaining payouts.
The scheduled job does not run	Review the job queue status, recurrence settings, and next scheduled run date and time. Confirm that the entry is set to Ready.