Xero Integration¶

Accept credit card payments on your Xero invoices through Blackstone. Once your Xero organisation is connected, customers can pay an invoice online and the payment is recorded back in Xero automatically - the invoice is marked Paid with no manual reconciliation.

How it works¶

flowchart LR
  A["Customer opens<br/>Xero invoice"] --> B["Secure payment page"]
  B --> C["Blackstone charges<br/>the card"]
  C --> D["Payment recorded<br/>in Xero"]
  D --> E["Invoice marked<br/>Paid"]

1. The customer opens their invoice and follows the payment link.
2. They enter their card on a secure payment page.
3. Blackstone charges the card and returns an authorization.
4. The payment is recorded against the invoice in Xero, which is marked Paid.

Before you begin¶

Connect your Xero organisation¶

1. Open the connection link¶

Open the connection link provided by Blackstone (e.g. https://api.bpayd.com/auth/connect) and click Connect to Xero.

2. Authorise access¶

Xero shows exactly what the integration can access - Invoices, Payments, and Organisation settings. Review and click Allow access.

Add a bank account in Xero¶

Blackstone payments are recorded against a bank account in Xero. If you don't have one yet, add it first.

1. Open the bank setup¶

In Xero go to Accounting → Bank accounts → Add bank account, then click Add without bank feed - you don't need to connect a real bank.

2. Fill in the account details¶

Give it a name like Blackstone Payments, choose the Other account type, enter an account number, then click Add and Finish adding accounts.

Complete onboarding¶

1. Select the bank account¶

After authorising, you're taken to the onboarding page. Choose Blackstone Payments from the dropdown.

2. Enter your Blackstone credentials¶

Fill in Username, Password, MID, CID, App Key, and App Type. Tick Use sandbox (test) mode while testing, then click Complete setup.

Take a payment¶

1. Create and approve an invoice¶

In Xero go to Sales → New invoice, add a contact, a line item, an amount and a due date, then click Approve.

2. Pay¶

Open the payment page for that invoice, enter the card details including the billing ZIP, and click Pay. On success the customer sees a confirmation.

Confirm the payment in Xero¶

The invoice status is now Paid and the amount due is 0.00. The invoice history shows a System Generated → Paid entry - the integration recording the payment automatically.

Refunds¶

Full and partial refunds are supported. A refund is processed through Blackstone and reconciled in Xero: a full refund reverses the payment; a partial refund reverses it and re-records the remaining net amount, so the invoice reflects the correct paid balance.

Going live¶

The "Pay Now" button¶

Troubleshooting¶