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

Troubleshooting Payment Posting Errors in Webgility Desktop Due to Unmapped Payment Methods

This article helps Webgility Desktop users in resolving and preventing “Missing payment method” errors in Webgility Desktop when posting orders or refunds. These errors occur when a payment method used such as "Shopify Payments" or "Cash on Delivery" does not exist in QuickBooks or hasn't been properly mapped. The issue typically arises when new sales channel payment options aren’t added in QuickBooks Desktop. The article guides support teams through identifying the missing method, adding it in QuickBooks Desktop, and ensuring correct mapping in Webgility Desktop to maintain smooth order and refund processing.

Overview

A common issue encountered when posting orders or refunds from Webgility Desktop to QuickBooks is the error message: "Missing payment method." This occurs when the payment method used in a transaction is not present or properly mapped in QuickBooks. This guide walks support staff through identifying, resolving, and preventing these errors, ensuring smooth order and refund processing—including for automated refunds.

Symptoms

  • Orders or refunds fail to sync/post from Webgility to QuickBooks.

  • Error in the Webgility activity log: “Missing payment method.”

  • Refunds may not process automatically due to unmapped payment methods.

Root Cause

This error typically appears when the payment method used in the order (e.g., "PayPal," "Credit Card," or "Shopify Payments") does not exist in the customer’s QuickBooks payment method list or is not properly mapped within Webgility Desktop.

Step-by-Step Resolution

1. Identify the Missing Payment Method

  • Open Webgility Desktop.

  • Go to Orders > Activity Log or review failed sync messages.

  • Locate the error and note the exact name of the missing payment method shown in the error.

2. Create the Missing Payment Method in QuickBooks

  • Open QuickBooks and log in as the Admin user.

  • Navigate to:

    • Lists > Customer & Vendor Profile Lists > Payment Method List (QuickBooks Desktop), or

    • Settings ⚙️ > All Lists > Payment Methods (QuickBooks Online).

  • Click New (or Add Payment Method) and enter the exact name of the payment method shown in Webgility.

  • Click Save to confirm.

3. Refresh Payment Methods in Webgility Desktop

  • In Webgility Desktop, go to:

    • Settings > Connections > QuickBooks > Payment Methods.

  • Click Refresh to import the latest payment method list from QuickBooks.

  • Locate the new method and ensure it is selected or mapped correctly.

4. Retry Posting the Order or Refund

  • Go back to the Orders section in Webgility.

  • Locate the failed order or refund.

  • Click Repost to QuickBooks.

  • Confirm that the transaction posts successfully without triggering the missing payment method error.

5. Configure Auto-Refund Settings (If Applicable)

  • For users leveraging Webgility's auto-refund feature:

    • Go to Settings > Connections > QuickBooks > Refund Settings.

    • Ensure that all payment methods expected to be used for refunds are present and mapped.

    • Test an automated refund to verify that the posting completes successfully.

6. Document and Communicate Resolution

  • Note the actions taken in the support case.

  • If this is a recurring issue, share the resolution steps internally for future reference.

  • Educate the customer on how to maintain matching payment method lists in both systems.