cashapp-pay

# Cash App Pay — Accept Payments from Cash App

Cash App Pay is a checkout solution by Block, Inc. that lets U.S. consumers pay
directly from their Cash App balance, linked bank account, or card. It eliminates
manual card entry and is optimized for mobile-first commerce.

Cash App is the **#1 personal finance app in the U.S.** by monthly active users.
Cash App Pay is available for e-commerce (web and mobile) and point-of-sale (POS)
integrations.

**Developer Docs:** [developers.cash.app](https://developers.cash.app)
**Production Base URL:** `https://api.cash.app`
**Sandbox Base URL:** `https://sandbox.api.cash.app`

---

## Architecture Overview

Cash App Pay integrations have two components:

```
┌─────────────────────────────────────────────────┐
│                   FRONT END                      │
│  Pay Kit SDK (Web / iOS / Android)               │
│  - Renders QR code (desktop) or redirect (mobile)│
│  - Handles customer authentication flow          │
│  - Uses Customer Request API under the hood      │
└───────────────────────┬─────────────────────────┘
                        │
                        ▼
┌─────────────────────────────────────────────────┐
│                   BACK END                       │
│  Network API     — Payments, merchants, disputes │
│  Management API  — Credentials, webhooks, keys   │
│  Batch Reporting — Settlements, dispute reports   │
│  (All server-side only — never call from browser)│
└─────────────────────────────────────────────────┘
```

---

## APIs

### Customer Request API (Client-side)

Handles linking a customer to a merchant. This is what Pay Kit uses under the hood.
Can also be called directly for API-only integrations.

| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | `/customer-request/v1/requests` | Create a customer request |
| GET | `/customer-request/v1/requests/{id}` | Retrieve a customer request (poll for status) |

**Actions** (specify one or more per request):

| Action | Descr...