Square Payments
"Square Payments Built for however you do business" - Square Payments is a comprehensive payment processing solution for in-person, online, and mobile transactions. [1]
Square Payments is a REST API for in-person, online, and mobile payment processing, covering use cases from hosted checkout and payment links to recurring subscriptions and marketplace payments. It operates in eight countries including the US, UK, Canada, Australia, and Japan, with published per-transaction pricing starting at $0.30 plus a percentage and a self-serve signup path. The API supports OAuth2 and API key auth, webhooks, idempotency, and ships official SDKs for seven languages including Node.js, Python, and Go. Security certifications include PCI DSS Level 1, SOC 2 Type 2, ISO 27001, and GDPR compliance.
Best for / Avoid if
Best for: Regulated or enterprise workloads - compliance attestations and an enterprise plan; AI agents and automation - an agent-ready surface (MCP / llms.txt); Teams needing broad API coverage out of the box
Avoid if: You want to try it free before paying
Pricing & procurement
- Pricing model
- Hybrid (base + usage)
- Published pricing
- ✓ Yes [2]
- Free tier
- ✗ No
- Self-serve signup
- ✓ Yes [3]
- Requires sales call
- ✗ No
- Enterprise plan
- ✓ Yes [4]
| Plan | Item | Per | Amount | Source |
|---|---|---|---|---|
| Free | In-person transaction (tap, dip, or swipe) | transaction | 2.6% + $0.15 | source |
| Plus | In-person transaction (tap, dip, or swipe) | transaction | 2.5% + $0.15 | source |
| Premium | In-person transaction (tap, dip, or swipe) | transaction | 2.4% + $0.15 | source |
| Free | Online or invoice transaction | transaction | 3.3% + $0.3 | source |
| Plus | Online or invoice transaction | transaction | 2.9% + $0.3 | source |
| Premium | Online or invoice transaction | transaction | 2.9% + $0.3 | source |
| Online API transaction (all plans) | transaction | 2.9% + $0.3 | source | |
| Manual entry or card on file transaction (all plans) | transaction | 3.5% + $0.15 | source | |
| Afterpay transaction (all plans) | transaction | 6% + $0.3 | source | |
| ACH bank transfer (1% rate, $1 minimum, plan-dependent caps) | transaction | 1% + $1 | source | |
| International card surcharge | transaction | 1.5% | source | |
| Free | Gift card load fee | transaction | 2.5% | source |
| Plus | Gift card load fee | transaction | 2.5% | source |
| Premium | Gift card load fee | transaction | 0% | source |
| Instant or same-day transfer to bank | transfer | 1.95% | source | |
| Standard next-business-day transfer to bank | transfer | 0% | source | |
| Bitcoin conversion fee | conversion | 1% | source | |
| Bitcoin rush withdrawal fee | withdrawal | $2 | source | |
| Bitcoin priority withdrawal fee | withdrawal | $3 | source | |
| Free | Monthly account fee | month | $0 | source |
| Plus | Monthly account fee | month | $49 | source |
| Premium | Monthly account fee | month | $149 | source |
| Chargeback / dispute fee | chargeback | $0 | source |
Capabilities
- Supported actions
- create_payment, update_payment, complete_payment, list_payments, refunds, hosted_checkout, payment_links, tokenization, 3ds_authentication, recurring_payments, card_on_file, dispute_management, apple_pay, google_pay, cash_app_pay, afterpay_clearpay, ach_bank_transfer, in_person_terminal, fraud_screening, subscriptions, invoices, multicurrency, delayed_capture, application_fees, webhook_events, oauth
- Regions
- United States, Canada, Australia, United Kingdom, Ireland, France, Spain, Japan [5]
- Input types
- Visa, Mastercard, American Express, Discover, JCB, UnionPay International, Diners Club, Interac, EFTPOS, Apple Pay, Google Pay, Cash App Pay, Afterpay/Clearpay, ACH bank transfer, Square gift cards, Bitcoin, Cash [6]
- Output types
- JSON, webhook events, hosted checkout page, payment link, settlement report, payout tracking, dispute management
- Webhooks
- ✓ Yes [7]
- Sandbox / test mode
- ✓ Yes [8]
- SDK languages
- Node.js, Python, Java, .NET, PHP, Ruby, Go [9]
- MCP server
- ✓ Yes [10]
Trust & compliance
- SOC 2
- SOC 2 Type II [11]
- HIPAA
- – Unknown
- GDPR
- ✓ Yes [12]
- ISO 27001
- ✓ Yes [13]
- PCI DSS
- ✓ Yes [14]
- Published SLA
- ✗ No
- Rate limits
- GraphQL API: 10 queries per second (10 QPS), max complexity 250 per query; REST API rate limits enforced but not publicly documented (429 RATE_LIMITED returned when exceeded) [15]
- Known restrictions
- PCI DSS Level 1 certified, ACH bank transfers US-only, Cash App Pay US-only, Cross-border card payments not supported (must process in country of account activation), Sellers processing over $250,000/year may qualify for custom rates (requires contacting sales), Bitcoin processing fee waived until December 31, 2026, Subscriptions API does not support ACH payments, Prohibited: firearms/ammunition sales, illegal goods/services
Developer surface
Integration
- API style
- rest
- Base URL
- https://connect.squareup.com/v2
- Version
- 2026-05-20
- Versioning
- header
- Stability
- ga
- Auth methods
- oauth2, api_key
- Idempotency keys
- ✓ Yes
- Error format
- vendor-specific
- Webhook signing
- hmac_sha256
Adoption & maturity
- Launched
- 2010-01-01
- Notable customers
- Shake Shack, Boston Beer Company
Other Online Card Payment APIs
PayPal Payments
"Accept payments in 200+ markets, 130+ currencies, and 30+ payment methods with a single, developer-friendly platform."
Adyen
"One platform for payments, data, and financial products. Built to scale with the world's leading businesses."
Razorpay
"India's All-in-One Finance Platform" that helps businesses accept payments, make payouts, manage banking, automate payroll, and access credit - all from a single platform.
Stripe
Financial infrastructure to grow your revenue.
Authorize.net
"We help make it easy to get paid. It's that simple."
Braintree (PayPal)
"A global payment processing solution that delivers end-to-end checkout experiences for businesses"
References
- ↑Description: squareup.com
- ↑Published pricing: squareup.com
- ↑Self-serve signup: squareup.com
- ↑Enterprise plan: squareup.com · squareup.com
- ↑Regions: developer.squareup.com
- ↑Input types: developer.squareup.com · developer.squareup.com
- ↑Webhooks: developer.squareup.com
- ↑Sandbox: developer.squareup.com
- ↑SDK languages: developer.squareup.com
- ↑MCP server: developer.squareup.com
- ↑SOC 2: squareup.com · squareup.com
- ↑GDPR: squareup.com · squareup.com
- ↑ISO 27001: squareup.com
- ↑PCI DSS: squareup.com · squareup.com
- ↑Rate limits: developer.squareup.com · developer.squareup.com
Change history
- 2026-06-21 Capabilities: {} → {"in_person":true,"recurring":true,"fraud_tools":true,"local_methods":true,"hos…
- 2026-06-21 Summary Md: (none) → Square Payments is a REST API for in-person, online, and mobile payment process…
- 2026-06-21 Scoring Methodology: (none) → Scores are computed deterministically from this profile's published, sourced fi…
- 2026-06-21 Score Pricing Transparency: (none) → 85
- 2026-06-21 Score Setup Speed: (none) → 75
- 2026-06-21 Score Docs Quality: (none) → 35
- 2026-06-21 Score Procurement Friction: (none) → 85
- 2026-06-21 Score Trust Readiness: (none) → 65
- 2026-06-21 Best For: (none) → Regulated or enterprise workloads - compliance attestations and an enterprise p…
- 2026-06-21 Avoid If: (none) → You want to try it free before paying
- 2026-06-21 Score Agent Friendliness: (none) → 65
- 2026-06-21 Has Structured Data: (none) → No
- 2026-06-21 Robots Allows Agents: (none) → Yes
- 2026-06-21 Changelog URL: (none) → https://squareup.com/whats-new
- 2026-06-21 Docs URL: (none) → https://developer.squareup.com/us/en
- 2026-06-21 Rendering: (none) → static
- 2026-06-21 Llms Txt URL: (none) → https://squareup.com/llms.txt
- 2026-06-21 Llms Txt Present: (none) → Yes
- 2026-06-21 Pricing Model: set to hybrid
- 2026-06-21 Has Published Pricing: set to Yes
- 2026-06-21 Free Tier Available: set to No
- 2026-06-21 Self Serve Signup: set to Yes
- 2026-06-21 Requires Sales Call: set to No
- 2026-06-21 Enterprise Plan Available: set to Yes
- 2026-06-21 SOC 2: set to type_2
- 2026-06-21 GDPR: set to Yes
- 2026-06-21 ISO 27001: set to Yes
- 2026-06-21 PCI DSS: set to Yes
- 2026-06-21 SLA Published: set to No
- 2026-06-21 Data Retention Policy URL: set to https://squareup.com/us/en/legal/general/privacy
- 2026-06-21 Documented Rate Limits: set to GraphQL API: 10 queries per second (10 QPS), max complexity 250 per query; REST…
- 2026-06-21 Known Restrictions: set to PCI DSS Level 1 certified, ACH bank transfers US-only, Cash App Pay US-only, Cr…
- 2026-06-21 Auth Methods: set to oauth2, api_key
- 2026-06-21 Auth Docs URL: set to https://developer.squareup.com/docs/oauth-api/overview
- 2026-06-21 API Style: set to rest
- 2026-06-21 Base URL: set to https://connect.squareup.com/v2
- 2026-06-21 API Version: set to 2026-05-20
- 2026-06-21 Versioning Scheme: set to header
- 2026-06-21 Stability: set to ga
- 2026-06-21 Quickstart URL: set to https://developer.squareup.com/docs/get-started
- 2026-06-21 Idempotency Supported: set to Yes
- 2026-06-21 Error Format: set to vendor-specific
- 2026-06-21 Webhook Signing: set to hmac_sha256
- 2026-06-21 Webhook Events URL: set to https://developer.squareup.com/docs/webhooks/v2webhook-events-tech-ref
- 2026-06-21 Requires Verification: set to Yes
- 2026-06-21 Slug: set to square
- 2026-06-21 Price Basis: set to transaction + percent
- 2026-06-21 Launched At: set to 2010-01-01
- 2026-06-21 Notable Customers: set to Shake Shack, Boston Beer Company
- 2026-06-21 Fields Not Found: set to hipaa, sla_published, soc2_type_explicit_source, rate_limit_requests, rate_limi…
Suggest an edit / leave a review
Leave a review or comment
curl -X POST https://apio.sh/api/feedback/square \
-H 'Content-Type: application/json' \
-d '{"kind":"review","rating":5,"body":"Your experience with this API…"}'Suggest a correction to a field (cite a source)
curl -X POST https://apio.sh/api/suggest/square/FIELD \
-H 'Content-Type: application/json' \
-d '{"value":"corrected value","citations":[{"url":"https://source.example/page","excerpt":"supporting quote"}],"note":"what changed and why"}'