# Square API

**Provider:** Square
**Category:** payments
**Base URL:** `https://connect.squareup.com/v2`
**Auth:** bearer — `Authorization: Bearer EAAAl...`
**Rate Limit:** 100 requests/s
**Free Tier:** Yes — available
**Pricing:** Pay per use (pay-as-you-go)
**Docs:** https://developer.squareup.com/docs

## Description

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.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | `https://connect.squareup.com/v2/payments` | Create a payment |
| GET | `https://connect.squareup.com/v2/payments` | List payments |
| POST | `https://connect.squareup.com/v2/orders` | Create an order |
| GET | `https://connect.squareup.com/v2/catalog/list` | List catalog items |
| POST | `https://connect.squareup.com/v2/customers` | Create a customer profile |
| GET | `https://connect.squareup.com/v2/locations` | List seller locations |

## Authentication

Pass your Square access token as a Bearer token. Use sandbox tokens for testing.

```
Authorization: Bearer EAAAl...
```

## Sample Request

```bash
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"
  }'
```

## Sample Response

```json
{
  "payment": {
    "id": "GQTFp1ZlXdpoW4o6eGiZhbjosiDFf",
    "status": "COMPLETED",
    "amount_money": {"amount": 100, "currency": "USD"},
    "total_money": {"amount": 103, "currency": "USD"},
    "created_at": "2024-01-18T12:00:00Z"
  }
}
```

## Pricing Details

In-person: 2.6% + $0.10. Online: 2.9% + $0.30. Keyed-in: 3.5% + $0.15. No monthly fee for basic processing.

---

*Source: [API Map](https://apimap.dev/apis/square/) — CC BY 4.0*