Tips for Payment & Tax Mapping in Hike–Xero Integration

Payment mapping.

If you see the error “Required payment paid to account (account name)” while syncing invoices between Hike POS and Xero, it means there’s no valid account code set for the payment account in Xero.

✅ Steps to Fix.

Log in to Xero.

Go to Accounting → Chart of Accounts.

Locate the account (e.g., Account name).

Assign an account code.

If the account doesn’t have a code, click Edit and assign a valid account code.

Save your changes.

Map the account in Hike.

In Hike POS, go to Integrations → Xero Settings → Payments. 

Refresh the list of accounts.

The updated Xero account (with the code) should now appear.

Map the corresponding Hike payment method to this account.

Retry the sync.

Once mapping is complete, re-sync the transaction. 

The error should be resolved, and payments will sync correctly.

🔎 Why this happens?

Hike requires each payment method to be linked to a valid Xero account. If an account in Xero doesn’t have an account code, Hike cannot recognize or map it, leading to this error.

Tip: Always ensure all your Xero bank/cash accounts have account codes assigned before mapping them in Hike.

⚠️ Important Note
If the same payment type is mapped across all payment mappings, any payment made in Xero will always sync to Hike as the Cash payment type by default.


Tax mapping.

Check Xero Tax Codes

Log in to Xero.

Navigate to Accounting → Advanced → Tax Rates.

Ensure all relevant tax codes (e.g., GST, VAT, Zero-rated) exist and are active.

Map Taxes in Hike

In Hike POS, go to Integrations → Xero Settings → Tax Mapping.

Select the Hike tax rates and map them to the corresponding Xero tax codes.

Verify Mapping

Test by creating a sale in Hike with tax applied.

Sync to Xero and check that the correct tax code is applied to the invoice.

👉 Best Practice Tip

• Always map unique Hike tax rates to their corresponding Xero tax codes.

• Avoid mapping multiple Hike tax rates to a single Xero code unless you intentionally want them combined.

• Related Articles

• How to integrate Xero with Hike

  Hike offers built-in integration with Xero, a seamless connection between your point of sale solution and accounting software. By pairing Hike and Xero, retailers can forgo laborious manual data entry, with precise accuracy of your data, that goes ...

• Tips for Payment & Tax Mapping in Hike–QuickBooks Online (QBO) Integration.

  Proper mapping of payments and taxes ensures smooth syncing between Hike POS and QBO. Incorrect mapping can cause misreported transactions or errors during sync. ✅ Payment Mapping Tips Check QBO Payment Accounts Log in to QuickBooks Online. Navigate ...

• Xero Integration - Settings Explained

  For a breakdown of what happens when you connect, read on, you’re in the right place. The below table helps explain what happens between Xero and Hike when they talk to each other, what data gets shared, and under which circumstances it happens. Xero ...

• Xero Error FAQ

  This article provides a brief idea of the errors that you might experience with Xero integration. For details on how to check the error log, please refer to How to Manage Xero - Error Log. This article explains the errors, their causes, and ...

• Video Tutorials - Integrations

  Hike & Shopify Integration: This video deciphers how to activate the Hike-Shopify eCommerce integration and how different options in the settings work with examples. Hike & BigCommerce Integration: This video untangles how to activate the ...