My invoice is in Xero but showing as unpaid

The invoice reached Xero but carries a balance. That's usually deliberate rather than a fault, and the badge on the order tells you which of six reasons applies.

Open Dashboard - Orders and look at the order's badge.

Nothing Due

No payment was attempted, by design. Either payments are switched off for the whole store, or for that order's payment gateway. The invoice will stay unpaid until you record the payment in Xero yourself.

See Sync invoices without posting payments if that isn't what you expected.

Awaiting Pay

Shopify hasn't captured the money yet. Common on net-terms or credit-account orders, where the customer is invoiced now and pays later. The payment posts once Shopify captures it.

Pay Pending

Shopify shows the order as partially paid or authorised. The app waits rather than posting a payment for the wrong amount. Click View on the order; the message names the reason.

Setup Needed or No Gateway

The order's payment gateway has no Xero bank or clearing account, so the payment has nowhere to go. Map it in Setup - Payouts and re-post the order.

The invoice is a draft in Xero

Xero won't accept a payment against a draft invoice. If your default invoice status is Draft, invoices stay unpaid until you approve them in Xero.

See Xero invoice status when posting orders.

Part Paid

A payment posted but didn't cover the invoice. Split payments across two gateways, and currency conversion on foreign-currency orders, are the usual causes. Check the invoice in Xero to see what was applied.

Still not clear?

Email us at help@hyvelabs.co with your shop URL, the order number, and the badge showing on the order.