Skip to content
  • There are no suggestions because the search field is empty.

How to Fix Payout Posting Errors for Shopify Orders with Split Payments in Webgility Desktop

This article helps Webgility Desktop users troubleshoot payout posting errors in Webgility Desktop for Shopify orders completed with split payments. It explains how incomplete or unsynchronized payment data can cause persistent errors and provides steps to diagnose and resolve these issues for accurate and complete payout processing.

Overview

When processing Shopify payouts in Webgility Desktop, split (two-part) payments can occasionally cause payout errors. These issues may block the payout from posting correctly or result in ongoing sync errors, even when the payout appears to have gone through.

Follow the steps below to diagnose and fix these problems, ensuring your split payment orders are fully reconciled and posted in QuickBooks without errors.

Common Causes

You may be encountering this issue due to:

  • An incomplete link between the two payment records for the order

  • A delay in Shopify’s system syncing payment status across modules

  • Manual edits to one of the payment entries not reflected in the payout workflow

  • Data mismatches between Shopify and the connected payment processor

Troubleshooting Steps

1. Verify Payment Completion in Shopify

  • Open the affected order in Shopify Admin > Orders

  • Confirm that both parts of the split payment are marked as Paid or Completed

2. Review the Order’s Transaction History

  • Check the Order  History in Shopify

  • Look for any failed, duplicate, or pending payments that might interrupt the payout

  • Document any unusual activity, especially around payment capture or refund attempts

3. Inspect Payout History in Shopify

  • Go to Settings > Payments > Payouts

  • Find the related payout and look for:

    • Error codes

    • Duplicate payout attempts

    • Manual reversals or failed posts

  • Take note of any error messages for reference

4. Check for Third-Party Sync Issues

  • If you’re using an external payment processor (e.g., PayPal, Klarna, etc.), compare its transaction log with Shopify’s

  • If the records don’t match, attempt to resync the data or manually update the status

Resolution Steps

1. Reconcile and Refresh the Order Data

  • Refresh the order page in Shopify

  • If available, use the Resync feature.

  • For desynchronized orders, manually correct the payment status or use the Shopify API to update it

2. Retry Payout Posting in Webgility Desktop

  • Once you’ve confirmed both parts of the split payment are recognized as complete:

    • Return to Webgility Desktop > Shopify > Payouts

    • Select the affected payout

Click Post to QuickBooks Desktop