What happens to historical Square data when I first connect to Bill.com?

Square exposes the last two years 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 Bill.com ledger, and re-running the backfill is safe because Well tracks the Square record IDs and updates existing Bill.com entries instead of duplicating them.

Does Well handle multi-currency records between Square and Bill.com?

Square carries the original transaction currency on every record and Bill.com natively ledgers in multiple currencies. Well preserves the original amount, applies your Bill.com chart-of-accounts conversion rules at posting time, and both the source and converted amounts ride on the document Well forwards to Bill.com, so the Bill.com entry you post keeps both sides of the trade.

How does Well prevent duplicates when posting Square records to Bill.com?

Square sends each event with a stable resource ID that Well tracks against the Bill.com ledger. Webhook replays (which Square can issue for delivery retries) are recognised by ID and either skipped or used to update the existing Bill.com entry. Distinct records that look similar are caught by Well before posting, with the candidates surfaced in the review queue when confidence is ambiguous.

Can I customise which Square fields are sent to Bill.com?

The default mapping connects each Square record to the Bill.com bill shape (vendor, amount, due date, approval policy). Settings let you override the vendor source, swap default approvers, attach a different document on the bill, or pull GL codes from your connected data. Mapping versions are immutable for already-paid bills so audit traces stay intact.

What happens if a Square record fails to post to Bill.com?

When a record fails to post to Bill.com (validation rule, missing field, transient 5xx), Well retries automatically with backoff. Auth failures short-circuit the retry loop and notify the workspace owner; schema rejections are kept on the integration status page with a one-click retry-after-fix action pointing back at the original Square record. Nothing silently drops.

How does Well authenticate with Square and Bill.com?

Square'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 Bill.com email-in address once it clears the matching threshold; Bill.com creates the draft record from it and you confirm and post it. Well holds no write credential to Bill.com. Tokens are encrypted in transit under TLS 1.3. Anything Well holds between Square and Bill.com is encrypted at rest and handled in line with GDPR.

Square to Bill.com

Available

Native · Square

Native · Bill.com

Connect Square to Bill.com with Well

Each Square settlement is forwarded to Bill.com as a bill with the chargeback window tracked inside Well, so AP knows when the funds are unrecoverable before scheduling.

Connect both toolsView all integrations

Square

Source

The Square connection reads your Square account through the Square MCP server using OAuth.

Bill.com

Target

The Bill.

Why this pair

Square processes the inbound side (customer card payments) and Bill.

com runs the outbound side (vendor bills and scheduled payments). Connecting Square to Bill. com through Well surfaces every Square payout the business would normally use to cover operating cash and pairs it with the Bill. com vendor record so spend and revenue land on one workflow. Square's MCP server pushes payout events to Well; Bill. com's IVA OCR creates the bill from the PDF Well forwards to your inbox so it enters your approval workflow.

What Well does between Square and Bill.com

One-way: Square into Well into Bill.com
Sync mode: Real-time MCP push
Events arrive in seconds

Trigger from Square

7 events · pick one

Well engine·recipe·When a Square card payment is captured

Source

from payment · live webhook

Lemon Studio

via Square

Payment

When a Square card payment is captured

ch_1q5nk · 22 Apr 2026€1,284.00

Extract

6 fields read from Square

6 fields read

CustomerLemon Studio
Charge date22 Apr 2026
Charge amount€1,284.00
CurrencyEUR
Processing fee€37.24

Enrich

against your historical record graph

4 fields added

Customer recordLemon Studio
Domainlemonstudio.io
Tax idFR42514682431
Sales journalVE · 2026

Confidence97%

<55% refused55–85% review≥85% auto-posts

Post

schedule as bills

Create a bill in Bill.com inbox

auto-posted

posted

TypeBill
VendorLemon Studio
Amount€1,284.00
LedgerVE · 2026
Source docattached
Confidence97%

audit linkto Bill.com

Action in Bill.com

1 compatible with this trigger

Create a bill in Bill.com inbox

Bridge Square payouts to Bill.com reimbursements.

01Featured

Forward resolved Square documents to Bill.com

Well reads the invoices and transactions from Square, resolves the company behind each one, and forwards it to your Bill.com email-in address with the customer attached.

Resolve the customer behind a sale

Each company and payment detail from Square is matched to a canonical company inside Well, so the document reaching Bill.com names a verified business.

Carry the payment into approval

The Square transaction stays attached to what Well forwards, so the approver in Bill.com sees the sale behind the document without leaving the tool.

13 signals and actions across Square and Bill.com

When a Square payout is sent to your bank
Detects the moment Square dispatches a payout batch toward your bank account.
Trigger·Transaction
When a Square customer is updated
Detects changes to a Square customer's name, email, or stored payment method and refreshes the company record.
Trigger·Company
When a Square dispute is opened
Captures chargebacks with the contested payment and reason code.
Trigger·Transaction
When a Square order is completed
Captures the completed Square order with its line items, taxes, and the payment that settled it.
Trigger·Invoice
When a Square invoice is paid
Detects paid Square invoices with line items, applied discounts, and tax breakdown.
Trigger·Invoice
When a Square refund is issued
Captures partial and full refunds with the originating payment id.
Trigger·Transaction
When a Square payment includes a tip
Pulls the tip amount off the payment so it can be routed separately.
Trigger·Transaction
When a Square card payment is captured
Captures successful card-present and card-not-present payments with currency, fees, and customer linkage.
Trigger·Transaction
When a customer is created in Square
Pulls new customer records with name, email, and stored payment methods.
Trigger·Company

Reference

Field mapping for Square → Bill.com

10 fields across 2 record types, open to see the full table.

Transaction fields

5 fields flow from Square into Bill.com.

Square field	Label		Bill.com field	Label
payment.amount_money.amount	Payment amount	→	amount	Amount
payment.amount_money.currency	Currency	→	currency	Currency
payment.created_at	Charge date	→	process_date	Process date
payment.note	Description	→	memo	Memo
payment.id	Charge id	→	payment_id	Payment id

Invoice fields

5 fields flow from Square into Bill.com.

Square field	Label		Bill.com field	Label
invoice.invoice_number	Invoice number	→	invoice_number	Invoice number
invoice.invoice_date	Issue date	→	invoice_date	Invoice date
invoice.due_date	Due date	→	due_date	Due date
invoice.total_money.currency	Currency	→	currency	Currency
invoice.primary_recipient.customer_id	Customer	→	external_id	External id

Connect Square and Bill.com in three steps.

1
Connect Square
Click Connect with Square; Square's MCP server registers a Well client automatically. Square's MCP server registers a read-scoped Well client through DCR; no credential paste, no shared secret.
- AuthOAuth 2.0
2
Map your accounts
Well discovers Square's card payments, invoices, refunds, customers, payouts, disputes, and inventory adjustments and the the Bill.com inbox awaiting approval. Each payout is paired to its scheduled vendor payment by date and total; failed transfers reverse the linked payment automatically so the schedule self-corrects.
- Auto-post above85% confidence
- Overridemanual anytime
3
Connect Bill.com
In Bill.com, open Settings > Developer > API keys and create a key paired with your developer ID. Paste the key into Well; Bill.com's discovery endpoints are reached over TLS 1.3 and the secret is never echoed in the UI.
- AuthConnect
- First sync~10 min

50 agent skills run on Square and Bill.com.

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

Needs a source like these

Runway

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

Runway Stress Test

See how long your cash lasts if a customer pays late, leaves, or you hire.

Cash position

Know how much cash you hold right now, with the accounts counted and the ones left out both stated.

Cost structure

See a company's or household's spend by category, supplier and trend; not for savings: use Subscription spend.

Money leak finder

Find the double charges and price rises in your bank debits, each with the dates and amounts your bank shows.

Chase late invoices

Get a prioritized list of who to chase for payment, with their contact info and a message already drafted.

Secure Payroll

Know if payroll is safe, and which vendor bills to push if it is not.

Rank clients by LTV

Rank your most valuable customers by lifetime value, over a year you name or their whole life.

Customer Dependency

See how much of your revenue rides on a few customers, and what a late or lost one does to your cash.

Company profile

Everything you know about one company, in one view.

Payment and invoice lookup

Find what payment settled an invoice, or catch every payment that never got one.

Missing receipts

Find the bills with no paperwork attached, before an auditor does.

Invoice Compliance

Know which invoices are missing a legal line before your customer or the tax office does.

Burn rate

Know what you spend in an average month over a window you can see, with the months that carried no spend counted.

Recurring revenue

See the monthly run-rate of live subscriptions, or an invoice average when no typed subscriptions are present.

Cash forecast

See the settled month-end cash series and where the line goes from the last complete month.

Cash flow bridge

See how the month moved from opening cash to closing cash, with whatever does not reconcile named as its own step.

Missing supplier invoices

See which suppliers owe you paperwork, in each of your files, for a month, a quarter or this week.

Assign missing invoices

Put a name on every settled expense that still has no invoice.

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.

Accounting review

Work through your open accounting items by category.

Categorize your suppliers

Close the category gaps behind your spend before you close a month.

Board pack

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

Optimize Supplier Prices

See what you paid a supplier, how its price moved, and get the negotiation email drafted.

Subscription spend

See what each scheduled supplier costs a month and a year, how it moved, and where your workspaces can save.

Subscription actions

Act on a subscription you name or pick by number from a list: cancel, renegotiate or contest a double debit.

Personal spending

See what you spent on one category, such as groceries, this month and how that compares to a usual month.

Unposted and blocked

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

Check bank and books

Compare your bank with your books, list the gaps, and re-run what missed rows.

Answers better with these connected

Receivables aging

See which customers still owe you money: the unpaid and overdue invoices, how late each is, and the total.

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.

Invoice fetching agents

See exactly which agents would run, before any of them does.

Convert currencies

Turn mixed currencies into one number you can actually audit.

Payables aging

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

Compose a board

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

Revenue by customer

See how much each customer billed in a period, ranked by revenue, with the part you could not place named.

Supplier spend register

See what each supplier invoiced you over a year, ranked, with unplaced invoices counted.

Call and claim

Claim a refund or a compensation with the evidence in hand, and know what to say when you call.

VAT radar

See the VAT position your data suggests for a quarter, and which invoices to fix first.

Money back

Find money owed back to you: refunds, credit notes, VAT credits, double debits, then unpaid customer invoices.

Employer cost

Read a month of payslips, or each of several months, and state, per person, gross pay plus the employee deductions and the employer charges the payslip printed, then list the payroll related bills paid from the bank that no payslip carries.

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.

Uses them when they are there

Invoice design

Pick how an invoice prints, from the designs and records you already have.

Import a statement

Drop a statement you already have, and get its transactions as records.

Connects and checks them

Check your connections

See what is connected, what is syncing, and what is missing.

Build your context graph

Connect your AI apps and your tools, then see your business as one context graph.

Connect your bank

Get the bank feed in, and confirm it is really live.

Tax id chase

The companies you deal with that carry no tax identifier, listed before year end.

Browse all skills

How Square and Bill.com stay secure with Well

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

MCP server authEncrypted at restGDPR compliant

Scopes Well requestsmcp.squareup.com/sse

Read Square records
Scoped to card payments, invoices, refunds, customers, and related records. No access to anything else in your Square account.
granted
Deliver documents to your Bill.com inbox
Well forwards the extracted document to your Bill.com email-in address; Bill.com reads bills via email-in inbox, with vendor, invoice number, amount, and related records from it and you review and post. No write credential to Bill.com is requested.
granted
Modify or delete Square records
Not granted. Square 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 Square’s admin panel.

Frequently asked questions about Square and Bill.com on Well

01What happens to historical Square data when I first connect to Bill.com?: Square exposes the last two years 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 Bill.com ledger, and re-running the backfill is safe because Well tracks the Square record IDs and updates existing Bill.com entries instead of duplicating them.
02Does Well handle multi-currency records between Square and Bill.com?: Square carries the original transaction currency on every record and Bill.com natively ledgers in multiple currencies. Well preserves the original amount, applies your Bill.com chart-of-accounts conversion rules at posting time, and both the source and converted amounts ride on the document Well forwards to Bill.com, so the Bill.com entry you post keeps both sides of the trade.
03How does Well prevent duplicates when posting Square records to Bill.com?: Square sends each event with a stable resource ID that Well tracks against the Bill.com ledger. Webhook replays (which Square can issue for delivery retries) are recognised by ID and either skipped or used to update the existing Bill.com entry. Distinct records that look similar are caught by Well before posting, with the candidates surfaced in the review queue when confidence is ambiguous.
04Can I customise which Square fields are sent to Bill.com?: The default mapping connects each Square record to the Bill.com bill shape (vendor, amount, due date, approval policy). Settings let you override the vendor source, swap default approvers, attach a different document on the bill, or pull GL codes from your connected data. Mapping versions are immutable for already-paid bills so audit traces stay intact.
05What happens if a Square record fails to post to Bill.com?: When a record fails to post to Bill.com (validation rule, missing field, transient 5xx), Well retries automatically with backoff. Auth failures short-circuit the retry loop and notify the workspace owner; schema rejections are kept on the integration status page with a one-click retry-after-fix action pointing back at the original Square record. Nothing silently drops.
06How does Well authenticate with Square and Bill.com?: Square'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 Bill.com email-in address once it clears the matching threshold; Bill.com creates the draft record from it and you confirm and post it. Well holds no write credential to Bill.com. Tokens are encrypted in transit under TLS 1.3. Anything Well holds between Square and Bill.com is encrypted at rest and handled in line with GDPR.