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

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.