Square's API suite covers the full commerce lifecycle: accept payments in-person and online, manage product catalogs and inventory, handle employee shifts and payroll, book appointments, and run loyalty programs. Strong support for retail and restaurant verticals.
https://connect.squareup.com/v2
Auth type
Bearer Token
Auth header
Authorization: Bearer EAAAl...
Rate limit
100 requests/s
Pricing
Pay per use
Free quota
None
Documentation
https://developer.squareup.com/docs
Endpoint status
Server online — HTTP 404 — server is online but path returned an error (may require auth)365ms
(checked Mar 29, 2026)
Builder score
B
67%
builder-friendly
Pass your Square access token as a Bearer token. Use sandbox tokens for testing.
Authorization: Bearer EAAAl...
| Plan | Price/mo | Included |
|---|---|---|
| Standard | Free | No monthly fee, pay per transaction |
In-person: 2.6% + $0.10. Online: 2.9% + $0.30. Keyed-in: 3.5% + $0.15. No monthly fee for basic processing.
| Method | Path | Description |
|---|---|---|
| POST | /payments |
Create a payment |
| GET | /payments |
List payments |
| POST | /orders |
Create an order |
| GET | /catalog/list |
List catalog items |
| POST | /customers |
Create a customer profile |
| GET | /locations |
List seller locations |
curl https://connect.squareup.com/v2/payments \
-H "Square-Version: 2024-01-18" \
-H "Authorization: Bearer $SQUARE_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"source_id": "cnon:card-nonce-ok",
"amount_money": {"amount": 100, "currency": "USD"},
"idempotency_key": "unique-key-here"
}'
{
"payment": {
"id": "GQTFp1ZlXdpoW4o6eGiZhbjosiDFf",
"status": "COMPLETED",
"amount_money": {"amount": 100, "currency": "USD"},
"total_money": {"amount": 103, "currency": "USD"},
"created_at": "2024-01-18T12:00:00Z"
}
}
Data sourced from API Map. Always verify pricing and rate limits against the official Square documentation.