QuickBooks error code 620: TxnID cannot be linked

Problem Statement

When syncing invoices or payments from Chargebee to QuickBooks Online you see ERROR CODE: 620; TxnID cannot be linked (with detail Payment.Line.LinkedTxn.TxnId). The payment cannot be linked to the invoice because the customer context does not match.

Solution

This error occurs when the customer record in QuickBooks Online that was used when the invoice was created is different from the customer record used when the payment was created. The payment cannot be linked to the invoice because the customer context does not match.

To resolve it, the correct customer in QuickBooks Online must be identified and the mapping in Chargebee aligned with it.

Steps to Set It Up

1. In QuickBooks Online, open the customer that should be associated with the invoice and payment.
2. From the customer page URL, copy the customer ID (the numeric ID in the URL).
3. Share that QuickBooks Online customer ID with Chargebee Support so Chargebee can update the backend mapping and resolve the sync error.