Setting QuickBooks Online Deposit Customs Duty Account for Payout Processing

gennady · April 24, 2026, 9:44pm

Overview

When merchants sell physical goods to international buyers and collect customs duties at checkout through Shopify’s Duties and Import Taxes feature, those collected duties are deducted from each payout. When weintegrate creates the corresponding bank deposit record in QuickBooks Online, the Customs Duty Account setting tells it which QBO account to post that deduction to.

This setting is available on Professional and higher weintegrate subscriptions. On lower plans the field is visible but disabled, and weintegrate falls back to the Processing Fees Account.

Why This Setting Matters

Correct account classification. Customs duty is a pass-through amount — you collected it from the buyer and owe it to the customs authority of the destination country. Posting it to a dedicated Other Current Liability account (rather than an expense account) correctly reflects that this money was never yours to keep.
Clean audit trail. A dedicated account makes it immediately clear in QBO how much customs duty moved through your books in any period, which is essential when preparing cross-border remittances or responding to customs inquiries.
Separation from import tax. Customs duty and import tax are distinct charges that may both appear on the same international order. Posting each to its own account gives you accurate visibility into both and avoids conflating different regulatory obligations in your books.
Reconciliation accuracy. When the customs duty deduction appears on its own line in the deposit record, the difference between your gross sales and your net bank deposit is fully explained, making reconciliation faster and more reliable.
Optional class tracking. If you use QuickBooks Online Classes, you can assign a class to the customs duty line for multi-location or departmental reporting.

Background: What Is Customs Duty in Shopify?

Customs duty — also referred to as import duty or tariff — is a charge imposed by the customs authority of the destination country on physical goods crossing an international border. Unlike import tax (which is typically a VAT or GST-style percentage on the value of goods), customs duty is calculated based on the product’s tariff classification code (HS code) and its country of origin, and can vary significantly by product type and destination.

When you use Shopify’s Duties and Import Taxes feature, Shopify can calculate and collect both import taxes and customs duties from your international buyers at checkout. The collected duties are then deducted from your payout — Shopify has received the funds from your buyer, and you are responsible for remitting them to the relevant customs authority.

Because customs duty is money collected on behalf of a government authority (not a merchant expense and not your income), the correct QuickBooks Online account type is Other Current Liability. This is the same classification as Import Tax and Marketplace Sales Tax — all three are pass-through liabilities. Keeping customs duty on its own dedicated account, separate from import tax, ensures your books accurately reflect each distinct obligation.

Prerequisites

Before configuring this setting, make sure you have the following in place:

Professional plan or higher. This setting is available on Professional and higher plans. On lower plans the field is visible but disabled, and weintegrate falls back to the Processing Fees Account.
A QBO Other Current Liability account for customs duty. Create an account in QuickBooks Online of type Other Current Liability to represent collected customs duties. Common names include Customs Duty Payable, Import Duty Payable, or Duties & Tariffs Payable. If no suitable account exists, create one in QBO before returning to this page.
An active Shopify → QuickBooks Online connection. This setting is part of the Deposits configuration for a specific store connection.
QBO Classes configured (optional). If you want to assign a QBO Class to the customs duty line, make sure at least one Class exists in your QuickBooks Online company. The Assign Class to Customs Duty checkbox is automatically disabled when no Classes are found.

How to Configure the Customs Duty Account

Step 1 — Open your Shopify connection settings

Log in to your weintegrate account.
Go to Connections in the left navigation and click the name of your Shopify store.
Select the Sales & Deposits tab (or advance to Step 7 — Sales Settings if you are in the setup wizard).

Step 2 — Locate the Deposits section

Scroll down past the Sales, Payment Method, and Conditional Sync Rules settings until you reach the Deposits section.

Step 3 — Select the Customs Duty Account

Find the Customs Duty Account dropdown.
Click the dropdown and start typing to filter your QBO Other Current Liability accounts.
Select the account you want weintegrate to use when posting customs duty deductions on each deposit record.

Note: This field is required on Professional and higher plans. The Save button (or the Next button in the setup wizard) will remain disabled until you make a selection here.

Class

Step 4 — Assign a Class to Customs Duty (optional) {class}

If you use QBO Classes and want to tag the customs duty line with a specific class:

Check Assign Class to Customs Duty. A Set Class as dropdown appears beneath it.
Select the class you want applied to the customs duty line item on every deposit record.

If the Assign Class to Customs Duty checkbox is grayed out, either your plan does not include this feature or your QuickBooks Online company has no Classes configured. See the Prerequisites section above.

Step 5 — Save your settings

Review your selections
Click Save or Next (depending on whether you’re in the setup wizard or editing an existing connection)
Your customs duty mapping will be applied to all future transactions

What Happens After Configuration

Once saved, weintegrate applies the account mapping to every payout deposit synced from Shopify:

Each deposit record created in QBO that includes a customs duty deduction will have a corresponding line item posted to the Other Current Liability account you selected. The amount matches exactly what Shopify deducted from the payout for collected customs duties.
If no customs duty was deducted from a payout (for example, all orders during that payout period shipped domestically, or the destination countries do not impose duties on your product types), no line item for this account is added to that deposit record.
If class assignment is enabled, the customs duty line item on every deposit record is tagged with the class you selected.
Payouts synced before you changed the setting are not retroactively updated. The new account applies only to deposit records created after you save.

Troubleshooting

The Customs Duty Account field is grayed out.
This setting is available on Professional and higher plans. On lower plans the field is visible but disabled, and weintegrate falls back to the Processing Fees Account. Upgrade your plan to enable it.

The Customs Duty Account dropdown is empty.
weintegrate populates this dropdown from the Other Current Liability accounts in your connected QuickBooks Online company. If the list is empty, no accounts of that type exist in QBO yet. Create an Other Current Liability account in QBO first, then return to this page.

The Save button stays disabled even after I selected an account.
Check that all other required fields in the Deposits section are also set — Deposit Bank Account, Processing Fees Account, Shipping Label Fees Account, Import Tax Account, and Customs Duty Account are all required on Professional and higher plans. Any one of them left at the placeholder will keep Save disabled.

The Assign Class to Customs Duty checkbox is grayed out.
Either your plan does not include this feature, or no Classes are configured in your QuickBooks Online company. To add Classes, go to Account and Settings → Advanced → Categories → Track classes in QBO, then return to this page.

I don’t see a customs duty line on my QBO deposit record.
Not all payouts include a customs duty deduction. This only appears when Shopify collected customs duties from international buyers during that payout period via the Duties and Import Taxes feature. Check the payout detail in Shopify Admin to confirm whether a customs duty deduction was included.

Customs duty is posting to the same account as import tax.
Customs duty and import tax are separate QBO fields that can each point to a different account. Verify that the Customs Duty Account and the Import Tax Account dropdowns are each set to their own dedicated Other Current Liability account, then save. Keeping them on separate accounts ensures each obligation is reported and remittable independently.

Customs duty is posting to the wrong account.
Update the Customs Duty Account dropdown to the correct account and save. The change takes effect for all deposit records created after you save. Historical deposits already in QBO will need to be corrected manually.