Square API
Square's unified commerce API for processing payments, managing inventory, customers, orders, and invoices across in-person POS and online channels.
Score Breakdown
⚙ Agent Friendliness
🔒 Security
OAuth2 with granular scopes. PCI DSS Level 1. SOC2 Type II. Card data tokenized. Use sandbox for all testing.
⚡ Reliability
Best When
An agent needs to handle payments for a US/CA/AU/UK/JP business with both online and in-person sales channels.
Avoid When
You need global payment processing across many countries, or don't need Square's POS ecosystem.
Use Cases
- • Processing card payments and refunds from agent workflows
- • Managing customer records and payment methods
- • Creating and sending invoices to customers
- • Inventory management for retail agents
- • Building appointment booking and payment systems
Not For
- • International-only businesses (Square is limited to select countries)
- • High-volume payment processing where Stripe's ecosystem is richer
- • Pure online payments without POS needs (Stripe may be simpler)
- • B2B invoicing at enterprise scale
Interface
Authentication
Personal access tokens for single-merchant use. OAuth2 for multi-merchant applications with fine-grained permission scopes. Sandbox environment available with test credentials.
Pricing
No monthly fee — pay per transaction only. Sandbox environment is free and full-featured for testing. Good economics for lower volume.
Agent Metadata
Known Gotchas
- ⚠ Geographic availability limited to US, CA, AU, UK, JP — international merchants cannot use Square
- ⚠ Sandbox and production use different access tokens and environments
- ⚠ Card tokenization (nonces) required for card data — cannot pass raw card numbers
- ⚠ Order versioning system requires understanding order state machine
- ⚠ Catalog IDs vs custom amounts require different payment flows
- ⚠ Webhook signature verification is essential — must validate HMAC-SHA256
Alternatives
Full Evaluation Report
Detailed scoring breakdown, competitive positioning, security analysis, and improvement recommendations for Square API.
Scores are editorial opinions as of 2026-03-06.