---
title: "Xero Invoice Payments Integration"
canonical: "https://bizcore.refined.site/space/BCKB/1785331713/Xero%20Invoice%20Payments%20Integration"
format: markdown
---
> Macro (toc)
# **Overview**
Invoices just got easier when you add 'Pay Now' button to your Xero invoice and let your customers pay with card.
> ✅ Requirements:
> ✅
> ✅ - Biz Core payments module subscription
> ✅ - Biz Core card payment service enabled
> ✅ - Xero account
> ✅ - Xero Custom connect subscription **(Costs: $10.00 per month) **[https://connect.xero.com/custom](https://connect.xero.com/custom)
# **Step 1 - Connect Xero Account to Biz Core**
1. Go to [developer.xero.com/app/manage](https://developer.xero.com/app/manage) and login (Use your normal Xero login email)
2. Click 'New app' button at the top right
3. Select the following details:
1. App name = Recommend ‘Biz Core Integration’ but can be named whatever you like
2. Select ‘Custom connection’
3. Company or application URL = [https://bizcore.com.au](https://bizcore.com.au/)
4. Tick the box ‘[I have read and agree to the Xero Developer Platform Terms & Conditions](https://developer.xero.com/xero-developer-platform-terms-conditions/)’
5. Click ‘Create app’ button
4. Select Scopes:
1. accounting.transactions,
2. accounting.transactions.read
3. accounting.reports.read
4. accounting.settings
5. accounting.settings.read
5. Select Authorised user (note: this should be the Xero user able to approve the integration)
6. Click ‘Save and connect’ button at the top right, an email to approve the custom Xero integration is sent to the authorised user email address
# **Step 2 - Approve and Set Up Pay Now Button**
1. You will receive an email that looks like the screenshot above, click ‘Connect’ button
2. A new tab will open:
1. Select your organisation from the dropdown menu
2. Click ‘Allow access' button (Note: if you can’t click ‘Allow access' ensure you are subscribed to the Custom connection app: **(Costs: $10.00 per month) **[https://connect.xero.com/custom](https://connect.xero.com/custom) )
3. Click on your organisation name dropdown at top left and click Settings
4. Select Payment services
5. Go down to Additional Payment Services and click ‘Add Other’ button and select ‘Custom Payment URL’
1. Account name = e.g. ‘Biz Core Invoice Payments’ but can be named whatever you like
2. Your custom URL = ‘[https://portal.bizcore.com.au/(payment:card-payment)?invoiceNo=[INVOICENUMBER]&subscriptionId=[SUBSCRIPTIONID]&mode=xeroInvoice](#)’
**Replace ‘[SUBSCRIPTIONID]’ with your Biz Core Subscription Id. In Biz Core, navigate to Subscription → Details and copy the Subscription Id**
:warning:** You DO NOT need to replace '[INVOICENUMBER]'**
**Example of complete custom URL =** ‘[https://portal.bizcore.com.au/(payment:card-payment)?invoiceNo=[INVOICENUMBER]&subscriptionId=c0e98d86-8eb5-421b-a0bc-c3487674ce28&mode=xeroInvoice](#)’
3. Pay now button text = e.g. 'Pay Now', this is the button text that will appear on your invoice
4. Click ‘Save’ button
6. On the same page, click ‘Manage themes’ button
1. On the desired Branding themes, in the Credit card column, select ‘Biz Core Invoice Payments' (or whatever you named the account) and then click 'Save’
# **Step 3 - Add API Key/Value Pairs to Biz Core**
> ⚠️ You will need the Subscription Manger role to perform this action on Biz Core.
> 📝 If you need to get back to the Developer Xero App Configuration screen, login to [developer.xero.com/app/manage](https://developer.xero.com/app/manage), click on the relevant app and click Configuration in the left-hand menu.
1. In Biz Core, navigate to Settings → Advanced → External Services and look for the Xero widget
2. You will need to add 3 Key/Value pairs to the Xero widget:
1. Client ID
1. Key = ClientId
2. Value = *Copy and enter the Client id value from the developer Xero app configuration (e.g. Copied client id e.g. 46852A2B3AA940FCBE16F33E1A648A64)*
2. Client Secret
1. Key = ClientSecret
2. Value = *Click the ‘Generate a secret’ button on the developer Xero app configuration, copy and enter the value (e.g. rO-85sO9rZlX4sOym2ZP5Wv-_68S-glUKVX-kQzJxA9VNuWY)*
3. Xero Code **(OPTIONAL)**
1. Key = code
2. Value = *On your business Xero account navigate to Accounting → Chart of accounts, copy and enter the code you want the invoice payments mapped to (e.g. 090 or 090-1)*
3. Click the Enabled toggle to enable the integration
> ⚠️ If you don’t copy the secret initially for whatever reason, you will need to delete the created one and generate a new one.
> ✅ Congratulations! Your Biz Core/Xero integration is complete and customers can now pay you directly from the invoice.
