Documented invoice payment flow

From invoice to payment record

The provider’s Xero guide describes customers paying an invoice through a hosted payment link. A successful payment is recorded against the invoice, which is marked Paid. The integration supports full and partial refunds.

Payment links and the native invoice button

The same guide tells merchants to share invoice payment links. It states that a native Pay Now button depends on Blackstone being approved as a Xero payment provider. Do not assume that button is already enabled on your invoices.

Connection and account setup

An authorized administrator

Setup requires administrator access to the Xero organization, provider credentials, and an account in Xero for recording payments. It includes authorization, disconnection, and sandbox steps. Have the responsible administrator review access before connecting.

Recording is not a bank deposit

A payment entry can settle an invoice balance in your books while the corresponding funds are still awaiting settlement. A ledger account used to record payments does not itself create a live bank feed or change the funding agreement.

Reconcile the invoice, refund, and deposit

A sample review

Suppose a customer pays a $500 invoice and later receives a $100 refund. Your test should show the payment reference, refund record, remaining paid amount, and the related bank activity. This is an illustrative test, not a promise about fee treatment.

Check the complete cost

Compare gateway charges, processing fees, connector costs, and refund pricing. Do not reconcile a gross invoice amount directly against a net deposit without allowing for separately documented fees and adjustments.

Exceptions to plan for

Payment approved but invoice unchanged

Check the provider transaction reference before collecting again. Assign someone to investigate delayed or duplicate records and to confirm the final status in both systems.

Your specific organization

Confirm currencies, multiple organizations, credit notes, partial payments, user roles, and reporting needs for the proposed connection. A documented invoice payment flow does not prove that inventory, payroll, or every accounting record synchronizes.