top of page

Payment method mapping errors

Confirm you’re mapping the exact payment method

TruSync matches on the exact payment method name your store reports — a mapping for “Credit Card” won’t cover an order that came through as “Visa” if your store reports them separately. Open the exception to see the exact payment method name TruSync received, then map that specific name in Settings → Payments.

Marketplace stores don’t need payment method mapping

Amazon and eBay orders post as Invoices, which don’t carry a payment method — if you’re seeing a payment-method exception on one of these stores, something unexpected is happening; contact support from your dashboard.

TruSync won’t auto-map to a default

This is deliberate — an incorrect auto-mapping creates more work later than waiting for an explicit one. Every payment method your store uses needs its own mapping before orders using it will sync.

TruSync does pre-select the choices it thinks are right and show them as suggestions, but they aren’t saved until you click Save these mappings in Settings → Payments. If you opened that screen, looked at the suggestions and navigated away, nothing was saved and your orders are still waiting in Order Exceptions.

Check the deposit account, not just the payment method

A mapping has two halves, and only one of them stops orders syncing. If the QuickBooks payment method is missing, orders become exceptions and you find out immediately. If the deposit account is wrong, orders sync perfectly well and post the money to the wrong account — which normally surfaces weeks later, when a bank reconciliation won’t balance.

Card payments — credit and debit cards, and card-backed wallets like Google Pay and Apple Pay — deposit to Undeposited Funds, because your processor pays them out to your bank in a batch covering many orders. PayPal-branded payments — PayPal, PayPal Pay Later, PayPal Credit, Venmo, and cards taken through PayPal checkout — deposit to your PayPal account, because the money lands in your PayPal balance.

The gateway’s name doesn’t decide which is which. Braintree handles both kinds, and names its own QuickBooks payment method “Braintree (PayPal)” even for card charges. If a payment method’s money doesn’t turn up where you expected, check that mapping’s deposit account first.

FAQ

Add paragraph text. Click “Edit Text” to update the font, size and more. To change and reuse text themes, go to Site Styles.

I mapped the payment method — why are older orders still stuck?

Existing exceptions clear once the mapping exists; if they haven’t after a short wait, contact support from your dashboard.

Can two different payment methods map to the same QuickBooks payment method?

Yes, if that’s how you want them grouped.

What if my store adds a new payment method later?

Orders using it will become exceptions until you add a mapping for it, the same as any other unmapped payment method.

I mapped everything, so why is money in the wrong QuickBooks account?

That’s the deposit account on the mapping, not the payment method. Card payments belong in Undeposited Funds and PayPal-branded payments in your PayPal account. Correct it in Settings → Payments and new orders follow the new mapping; documents already posted aren’t changed retroactively.
bottom of page