Square
Prepare factual Square Order context, execute payments in the merchant backend, and report actual Square outcomes.
On this page
Your backend keeps control of Square
Carden's Square integration is a server-to-server companion for a merchant's existing Square backend. Carden prepares a Square Order fragment from an authoritative inline or linked QuickBooks invoice. The merchant backend supplies Square credentials, location, customer, payment source, and provider idempotency; creates the Order and Payment; verifies provider webhooks; and reports outcomes.
| System | Responsibility |
|---|---|
| QuickBooks or inline input | Authoritative invoice, item, quantity, tax, shipping, discount, and reference facts. |
| Carden | Validation, immutable preparation, a mergeable Square Order fragment, and authenticated merchant-reported observations. |
| Merchant backend | Square auth, location and customer selection, Order and Payment idempotency, execution, webhook verification, and report delivery. |
| Square | Order calculation, payment processing, provider events, processing-fee records, and seller payout records. |
Create an Order before its Payment
Carden emits ad hoc Square order lines in source sequence with factual names, integral quantities, and base_price_money in invoice currency. Product codes, units, and commodity codes are preserved only as Square line metadata when present; metadata is not a dedicated commercial-card transmission field.
Source tax and discounts are represented at the transaction or line-item level selected by the invoice contract. Fixed amounts prevent Carden from inventing percentages. Positive shipping becomes an order-scoped fixed service charge. The adapter validates that the Square Order arithmetic equals the intended invoice total.
The returned fragment intentionally omits provider-owned location_id and idempotency_key. The merchant backend adds those values, creates the Order once, and uses the returned order_id in a separately idempotent CreatePayment whose amount matches the Square-computed total.
Implement Square in order
Setup
Configure the backend-owned Order and Payment workflow.
QuickBooks workflow
Prepare Square context from one linked source invoice.
Square SDK usage
Use all seven server SDKs or direct HTTP.
Square API
Review Order preparation and payment-report contracts.
Troubleshooting
Recover provider, arithmetic, identity, and report failures safely.
Keep bundled pricing and savings separate
Square bundled pricing generally combines processing costs into one rate. A lower underlying interchange category does not automatically lower the merchant's Square price. Confirm the seller's actual pricing agreement before treating qualification as recoverable savings.
Square Payment processing_fee and PayoutEntry records can support fee and payout reconciliation. Cost Plus adjustments may appear for eligible custom arrangements. The Carden payment-report endpoint records merchant-reported operations and does not independently import payout entries or establish network qualification.