1. Guides
Merchant Warrior API 2.0
  • API
    • Getting Started
    • Guides
      • Xero Connection
      • Xero Custom URL
      • wooCommerce PayID
      • Middleware
      • Hostaway
    • Direct API
      • getAccessToken
      • processCard
      • processAuth
      • processCapture
      • processBatch
      • retrieveBatch (CSV)
      • retrieveBatch (JSON Response)
      • retrieveBatch (JSON Notify)
      • refundCard
      • queryCard
      • processDDebit
      • processDDebitAuth
      • processVoid
      • verifyCard
      • queryDD
      • queryBIN
      • getSettlement
      • checkEnrollment
      • checkPARes
      • addBlacklistedCard
      • removeBlacklistedCard
      • queryBlacklistedCard
      • simulateNotify
      • getSurcharge
    • 3DS 2.0
      • Introduction
      • 3DS 2 Authentication Flows
      • Step 3 - 3DS Method Data
      • Step 5 - Challenge
      • Step 1 - getAccessToken
      • Step 2 - checkEnrollment
      • Step 4 - checkTDSAuth
      • Step 6 - checkPARes
      • Step 7 - processCard
      • Authorization Only processCard
    • PayLink
      • Introduction
      • Generate PayLink
    • PayID
      • Introduction
      • Create
      • Transaction
      • Get
      • Update
      • Status
      • List
      • Refund
    • PayTo
      • Introduction
      • Simulator
      • Certification
      • Actions and Statuses
      • Agreements
        • Agreements
        • Notifications
        • Create Agreement
        • Get Agreement
        • Amend Agreement
        • Amend Agreement Status
        • Recall Agreement Action
      • Payments
        • Payments
        • Notifications
        • Create Payment
        • Get Payment
        • Get Payment Status
        • Search Payments
    • Confirmation of Payee
      • Introduction
      • Sandbox Simulations
      • Validate
    • POS
      • Introduction
      • processPOS
      • refundPOS
      • voidPOS
      • deregisterPOS
    • Web SDK
      • Introduction
      • Usage
      • getAccessToken
      • Options
      • Initiate
      • Payframe Functionality
      • Middleware
      • addCard
    • Payframe
      • Introduction
      • Usage
      • Constructor
      • tdsCheck
      • Additional Functions
      • Styling
      • processCard
      • processAuth
    • Digital Wallets
      • Apple Pay Prerequisites
      • Google Pay Prerequisites
      • Web SDK
      • Manual Integration
      • processCard
      • addCard
      • getMerchantSession
      • decryptApplePayToken
    • Token Payments
      • Introduction
      • Key Management
      • addCard
      • removeCard
      • cardInfo
      • changeExpiry
      • processCard
      • processAuth
    • Batch
      • Introduction
      • Card Batches
      • Token Batches
      • Direct Debit Batches
    • Forter
      • Introduction
      • Testing
    • Payouts
      • Introduction
      • Sandbox Simulations
      • Notifications
      • Create Payouts
      • Get Payout Status
      • Resend Notifications
      • Get Payout Transaction Status
      • Get Payout Transaction Notify
    • Partner API
      • Introduction
      • addMerchant
      • updateMerchant
      • checkMerchant
    • Notifications
      • Notifications
  • Hosted Payment Page
    • processCard
  1. Guides

Xero Connection

Connect Xero to Merchant Warrior#

Connect your Xero organisation to Merchant Warrior to add Merchant Warrior as a payment option on your Xero invoices and automatically reconcile Invoice payments and processing fees.
The integration is configured from the Merchant Warrior portal. You do not need to manually create a Custom Payment URL or payment service in Xero.

Before you begin#

Ensure that:
Xero integration is available on your Merchant Warrior account. If it is not, please contact Merchant Warrior to enable Xero on your account.
You can sign in to the Xero organisation you want to connect.
Your Xero user has permission to authorise the connection and access the required accounting settings.

Connect your Xero organisation#

1.
Sign in to Merchant Warrior - Barracks.
2.
Open the Xero Integration settings.
3.
Click Authorize with Xero.
4.
Sign in to Xero if prompted.
5.
Select the Xero organisation you want Merchant Warrior to access.
6.
Review the requested permissions and approve the connection.
7.
After returning to Merchant Warrior, select the organisation from Xero Organisation.
The Tenant ID and Tenant Name are populated automatically for the selected organisation.
If the required organisation is not listed, click Authorize with Xero again and grant access to it.

Configure the integration#

Complete each setting shown in the Xero Integration section.

Payment Account#

The payment account is used to record payments received through Merchant Warrior.
Click Setup to create the recommended account in Xero; or
Click Select Existing to use a compatible account that already exists.

Settlement Account#

The settlement account is used when Merchant Warrior settlements are reconciled in Xero.
Click Select and choose the Xero bank or clearing account that receives Merchant Warrior settlements.

Fees Account#

The fees account is used to record Merchant Warrior processing fees.
Click Select and choose the appropriate expense account, such as Bank Fees.

Fees Contact#

The fees contact is assigned to Xero transactions created for Merchant Warrior fees.
Click Setup to create the recommended Merchant Warrior contact; or
Click Select Existing to use an existing contact.

Branding Theme#

Merchant Warrior can be applied to any Xero branding theme for customers to use it to pay invoices.
1.
Click Setup.
2.
Select each branding theme that should offer Merchant Warrior as a payment option.
3.
Save your selection.
Merchant Warrior configures the payment service against the selected branding themes. No manual changes are required in Xero.

Enable the integration#

After all required settings are complete:
1.
Review the selected organisation, accounts, contact and branding themes.
2.
click Save Details.
3.
Confirm that the page reloads and status changes to Enabled.
image.png
Merchant Warrior is now available as a payment option on invoices that use one of the configured Xero branding themes.

Change the configuration#

You can return to the Xero Integration settings at any time to:
Select a different authorised Xero organisation.
Change the payment, settlement or fees account.
Change the fees contact.
Add or remove branding themes.
Review the integration status after making changes to confirm it remains enabled.

Disconnect Xero#

To remove Merchant Warrior's access to the selected Xero organisation, click Disconnect from Xero.
image.png
Disconnecting stops the integration. Customers will no longer be able to use Merchant Warrior through the disconnected configuration until Xero is authorised and the integration is enabled again.

Troubleshooting#

My organisation is not listed#

Click Authorize with Xero and grant Merchant Warrior access to the required organisation. Then return to the integration settings and select it from Xero Organisation.

Xero Authenticated - No New Organisations#

Check that the Organisation does not already exist in the selection dropdown
1.
Go to Xero Settings
image.png
2.
Click on Connected apps
image.png
3.
Disconnect "Merchant Warrior"
4.
Follow the Connect your Xero organisation steps above.

The status is not enabled#

Check that the following settings are complete:
Payment Account
Settlement Account
Fees Account
Fees Contact
After completing any missing settings, click Save Details and review the Status field.

I cannot authorise the connection#

Confirm that your Xero user has access to the organisation and sufficient permission to approve the connection. If required, ask an authorised Xero administrator to complete the authorisation.
Modified at 2026-07-30 03:04:42
Previous
Guides
Next
Xero Custom URL
Built with