PayPalXeroPayPal to Xero
AvailableNative · PayPalNative · Xero

Connect PayPal to Xero with Well

PayPal settles in batches; Well decomposes each payout into its component charges and forwards a clean per-customer document to Xero's inbox, with VAT and fee context attached.

About PayPal and Xero

PayPal
PayPal
Source

The PayPal integration connects your payment account to Well via MCP, importing transactions, fees, settlements, and refund data.

Xero
Xero
Target

The Xero integration connects Well to your accounting platform for bidirectional data flow.

Why this pair

PayPal generates more accounting work per transaction than most processors: refunds, holds, dispute reserves, and currency conversions all on different value dates.

Xero accepts emailed PDFs and creates draft bills via Hubdoc, but does not unwind PayPal activity on its own. Connecting PayPal to Xero through Well matches each PayPal event inside its own ledger with fees split out and currency conversions stamped on the value date, then forwards the matched document to Xero's email-in for draft-bill creation.

What Well does between PayPal and Xero

  • One-way: PayPal into Well into Xero
  • Sync mode: Real-time MCP push
  • Events arrive in seconds
PayPal
Trigger from PayPal
11 events · pick one
Well engine·recipe·When a PayPal payment is captured
Source
from payment · live webhook
Mosaic Health
via PayPal
Payment
When a PayPal payment is captured
ch_1q5nk · 22 Apr 2026€1,284.00
Extract
6 fields read from PayPal
6 fields read
  • CustomerMosaic Health
  • Charge date22 Apr 2026
  • Charge amount€1,284.00
  • CurrencyEUR
  • Processing fee€37.24
Enrich
against your historical record graph
4 fields added
  • Customer recordMosaic Health
  • Domainmosaichealth.app
  • Tax idFR65432187654
  • Sales journalVE · 2026
Confidence97%
<55% refused55–85% review≥85% auto-posts
Post
post as draft bills
Create a draft bill in Xero
auto-posted
posted
  • TypeBill
  • VendorMosaic Health
  • Amount€1,284.00
  • LedgerVE · 2026
  • Source docattached
  • Confidence97%
audit linkto Xero
Xero
Action in Xero
1 compatible with this trigger
Create a draft bill in Xero

Reconcile PayPal multi-currency charges to Xero entries.

01Featured

Bring a PayPal invoice in

Well reads an invoice from PayPal and forwards it to your Xero email-in address, so the entry is created without anyone re-keying it.

02

Match against records Well reads from Xero

Well reads your contacts and invoices from Xero and checks each PayPal document against them, so it lands matched rather than as a fresh unknown.

03

Keep the PayPal reference attached

The PayPal transaction reference travels with the document forwarded to Xero, so each entry traces back to the payment it came from.

04

Catch a duplicate early

Well checks a PayPal invoice against what it has forwarded and what Xero holds, so the same entry is not recorded twice.

16 signals and actions across PayPal and Xero

  • When a PayPal payment is captured

    Pulls from PayPal transaction events. Captures completed PayPal payments with buyer, amount, and order id. Forwarded to Xero's email-in via Hubdoc; Hubdoc extracts contact, dates, totals, and tax type into a draft bill.

    Trigger·Transaction
  • When a PayPal payment is refunded

    Pulls from PayPal transaction events. Detects refunds against captured payments and links back to the order. Forwarded to Xero's email-in via Hubdoc; Hubdoc extracts contact, dates, totals, and tax type into a draft bill.

    Trigger·Transaction
  • When a PayPal payout settles

    Pulls from PayPal transaction events. Tracks settlement batches with the covered captures and processing fees. Forwarded to Xero's email-in via Hubdoc; Hubdoc extracts contact, dates, totals, and tax type into a draft bill.

    Trigger·Transaction
  • When a new buyer's first PayPal capture is recorded

    Pulls from PayPal transaction events. Recognises a first-time buyer from the capture and prepares a customer record. Forwarded to Xero's email-in via Hubdoc; Hubdoc extracts contact, dates, totals, and tax type into a draft bill.

    Trigger·Company
  • When a PayPal chargeback is filed

    Pulls from PayPal transaction events. Flags the contested transaction and preserves the dispute trail. Forwarded to Xero's email-in via Hubdoc; Hubdoc extracts contact, dates, totals, and tax type into a draft bill.

    Trigger·Transaction
  • When a PayPal-issued invoice is paid

    Pulls from PayPal transaction events. Captures invoices issued through PayPal with line items and tax. Forwarded to Xero's email-in via Hubdoc; Hubdoc extracts contact, dates, totals, and tax type into a draft bill.

    Trigger·Invoice
  • When a PayPal capture is denied

    Pulls from PayPal transaction events. Surfaces denied captures with the denial reason for follow-up. Forwarded to Xero's email-in via Hubdoc; Hubdoc extracts contact, dates, totals, and tax type into a draft bill.

    Trigger·Transaction
  • When a PayPal payment is held pending review

    Pulls from PayPal transaction events. Detects pending captures and waits for the resolution before posting. Forwarded to Xero's email-in via Hubdoc; Hubdoc extracts contact, dates, totals, and tax type into a draft bill.

    Trigger·Transaction
  • When a PayPal capture is recorded with its merchant fee

    Pulls from PayPal transaction events. Pulls the merchant fee out of the capture so net revenue is correct. Forwarded to Xero's email-in via Hubdoc; Hubdoc extracts contact, dates, totals, and tax type into a draft bill.

    Trigger·Transaction
Reference
Field mapping for PayPal → Xero
7 fields across 2 record types, open to see the full table.

Transaction fields

4 fields flow from PayPal into Xero.

PayPal fieldXero field
capture.amount.currency_codeCurrencyCode
capture.create_timeDate
capture.idBankTransactionID
capture.seller_receivable.feeTotal

Invoice fields

3 fields flow from PayPal into Xero.

PayPal fieldXero field
invoice.detail.invoice_numberInvoiceNumber
invoice.detail.invoice_dateDate
invoice.amount.currency_codeCurrencyCode

Connect PayPal and Xero in three steps.

  1. PayPal1

    Connect PayPal

    Click Connect with PayPal; the PayPal MCP server registers a Well client automatically. PayPal's MCP server registers a read-scoped Well client through DCR; no credential paste, no shared secret.

    • AuthOAuth 2.0
  2. 2

    Map your accounts

    Well discovers PayPal's completed payments, refunds, disputes, holds, and currency-conversion events and the the Xero draft bills queue populated by Hubdoc. Match candidates are scored on counterparty name, amount, currency, and reference; you approve any that need a human eye and Well saves the rule for the next batch.

    • Auto-post above85% confidence
    • Overridemanual anytime
  3. Xero3

    Connect Xero

    Click Connect with Xero; Well's OAuth proxy handles Xero authorisation through Dynamic Client Registration. Xero's MCP server registers a write-scoped Well client through DCR; no credential paste, no shared secret.

    • AuthOAuth 2.0
    • First syncup to an hour

32 agent skills run on PayPal and Xero.

Each one answers a question from the data this pair brings in. The required ones return nothing until a source like it is connected.

Answers better with these connected

Runway

Know how many months of cash you have at your current burn, with both sides of the division shown.

Cost structure

See where your company's money actually goes, no spreadsheets required.

Receivables aging

See who owes you money, and how long they have been sitting on it.

Bills due

See what you owe and when, ordered by due date with a running total.

FX exposure

See how much of your cash and receivables sit outside your reporting currency.

Missing supplier invoices

See which suppliers owe you paperwork, before your accountant asks.

Missing invoice sweep

Walk the whole month-end sweep in one prompt.

Close the books

Drive the month-end close from open to sent to your accounting tool.

Payables aging

See what you owe your suppliers, and how long each bill has been past due.

Board pack

The board numbers in one pass, each with its scope and its window stated.

Compose a board

The measures you name, arranged on one board that stores the question rather than the answer.

Revenue by customer

See which customers your revenue came from in a period, ranked, with the part you could not place named.

Supplier spend register

See what you paid each supplier over a year, ranked, with the invoices that could not be placed counted beside the total.

Unposted and blocked

See what in a month has not reached the ledger, and which pile each item sits in.

Check bank and books

Check that your bank and your books match, and re-run what missed rows.

Money back

Find the supplier refunds, VAT credits and expense notes still owed to you, with the evidence for each.

Check contractor status

For each supplier that looks like a freelancer, read the purchase invoices, the payment rail and any contract Well holds, and state the facts a requalification question turns on, next to the papers your country expects you to keep.

How PayPal and Xero stay secure with Well

Well connects to PayPal through its MCP server, which issues short-lived access tokens via Dynamic Client Registration. Well never holds a long-lived PayPal secret; the server refreshes its own tokens on each session. Anything Well holds between PayPal and Xero is encrypted at rest and handled in line with GDPR.

MCP server authEncrypted at restGDPR compliant
Scopes Well requestsmcp.paypal.com/mcp
  • Read PayPal records

    Scoped to completed payments, refunds, disputes, holds, and related records. No access to anything else in your PayPal account.

    granted
  • Deliver documents to your Xero inbox

    Well forwards the extracted document to your Xero email-in address; Xero reads draft bills via email-in, with contact, dates, totals, and related records from it and you review and post. No write credential to Xero is requested.

    granted
  • Modify or delete PayPal records

    Not granted. PayPal is read-only on Well's side; the source of truth never moves.

    refused
  • Read other workspaces' data

    Not granted. A session resolves only to the workspaces your account belongs to, and Well checks that membership before it returns any record.

    refused
Disconnect any time from Well settings or PayPal’s admin panel.

Frequently asked questions about PayPal and Xero on Well

01What PayPal data does Well pull into Xero?
PayPal streams completed payments, refunds, disputes, holds, and currency-conversion events to Well over its MCP server. After Well resolves the counterparty and assigns a confidence score, the matched record posts to Xero as draft bills via email-in, with contact, dates, totals, line items, and tax type extracted by Hubdoc, with the PayPal event ID preserved on the entry for audit.
02How often does PayPal data sync to Xero?
PayPal pushes events to Well over its MCP server, so most records land within seconds of the underlying action. Each event is matched immediately and reaches Xero within a confidence window: above 85% it posts, 55-85% queues for review, below 55% is refused.
03How does Well match PayPal records to entries in Xero?
Every PayPal charge is scored against your open Xero sales invoices and existing customer records on customer name, amount, currency, and reference. Above 85% the charge collapses onto the right invoice and Xero reconciliation builds the matched journal entry in Well's ledger, the ledger accounts mapped and the matched customer and payment pre-filled, ready for you to post to Xero. Between 55% and 85% the candidate list is queued for review with the alternative customers ranked.
04What happens to historical PayPal data when I first connect to Xero?
PayPal exposes the last full year through its API on a connected account. The window Well actually pulls is configurable from the integration settings page; each record is matched against your existing Xero ledger, and re-running the backfill is safe because Well tracks the PayPal record IDs and updates existing Xero entries instead of duplicating them.
05Does Well handle multi-currency records between PayPal and Xero?
PayPal carries the original transaction currency on every record and Xero natively ledgers in multiple currencies. Well preserves the original amount, applies your Xero chart-of-accounts conversion rules at posting time, and both the source and converted amounts ride on the document Well forwards to Xero, so the Xero entry you post keeps both sides of the trade.
06How does Well authenticate with PayPal and Xero?
PayPal's MCP server handles authorisation directly; Well receives an access token through Dynamic Client Registration and never sees raw user credentials. For the delivery side, Well forwards the reconciled document to your Xero email-in address once it clears the matching threshold; Xero creates the draft record from it and you confirm and post it. Well holds no write credential to Xero. Tokens are encrypted in transit under TLS 1.3. Anything Well holds between PayPal and Xero is encrypted at rest and handled in line with GDPR.
PayPalXero

Connect PayPal to Xero.

Connect both sides. Each PayPal transaction flows into Xero with tax handled.

  • Read-only scopes on PayPal
  • AES-256 at rest, TLS 1.3 in transit
  • GDPR compliant
  • Revocable Xero access in one click