Cash App Payment API
The real integration routes for developers — from Square’s Cash App Pay to hosted-link and webhook orchestration for approved digital businesses.
Cash App does not publish a standalone public API for arbitrary third parties. The supported routes are Cash App Pay through Square’s Web Payments SDK for approved sellers, and a third-party orchestration API that adds hosted links, QR, webhooks, and Cash App routing through approved channel partners for categories Square will not underwrite.
Does Cash App have a public API?
Short answer: not a standalone one. Cash App is a consumer product owned by Block, the parent of Square. There is no open Cash App developer portal where any business can request keys and move money directly. Instead, Cash App acceptance reaches developers through two channels:
- Square’s APIs expose Cash App Pay as a payment method for approved Square sellers.
- Orchestration providers connect Cash App acceptance through approved channel partners and expose their own API, links, and webhooks — the route for digital and high-risk categories.
The integration routes
Route A — Cash App Pay via Square Web Payments SDK
If your category is accepted by Square, this is the canonical developer path. You load Square’s Web Payments SDK on the checkout page, render the Cash App Pay button, tokenize the buyer’s approval, and complete the charge with Square’s Payments API server-side. You subscribe to Square webhooks for payment lifecycle events. It is well-documented, PCI-friendly, and settles through Square.
Route B — Hosted payment links and webhooks (no SDK)
When you do not want to build a front-end checkout, you call an orchestration API to create a hosted payment link, redirect or message the buyer to it, and receive a webhook when the payment resolves. No card fields touch your servers. This is the fastest path to a first live Cash App payment and is how most Polapine integrations start.
Route C — Third-party orchestration API
The orchestration API generalizes Route B. One set of credentials lets you create payment links, route Cash App (plus crypto, Apple Pay, and Google Pay) through approved channel partners, attach order and campaign context, and consume a single unified webhook stream regardless of the underlying rail. It is the route used by digital goods, subscriptions, and approved high-risk verticals that cannot use Square directly.
Webhooks and payment status
Whatever route you choose, your integration is driven by payment-status events. Handle at least three states so fulfilment and reconciliation stay correct:
- completed — release the product, license, credit, or access.
- failed — surface a retry path; do not fulfil.
- pending — hold fulfilment until it resolves.
Persist both the provider transaction ID and your own order ID on every record so support and dispute handling can match a payment to an order. A representative orchestration webhook payload:
POST /your-endpoint/cash-app-webhook
{
"event": "payment.completed",
"invoice_id": "PD-10K3F9",
"order_id": "your-internal-7741",
"method": "cash_app",
"amount": "49.00",
"currency": "USD",
"status": "completed",
"provider_tx_id": "ch_3Nf...",
"created_at": "2026-06-04T15:22:08Z"
}Square Cash App Pay vs orchestration API
| Dimension | Cash App Pay via Square | Orchestration API |
|---|---|---|
| Front-end work | Web Payments SDK on your checkout | Optional — hosted link or QR, no SDK required |
| Eligible categories | Square acceptable-use only | Digital & approved high-risk, by underwriting |
| Other rails | Square’s supported methods | Cash App, crypto, Apple Pay, Google Pay |
| Webhooks | Square event types | Unified stream across rails |
| Custody | Settles through Square | Settles through provider/partner; orchestrator takes no custody |
| Bring your own keys | N/A | Supported |
Example integration flow
- Create a payment link via the API with your order ID, amount, and Cash App as the priority rail.
- Deliver the link or QR to the buyer (redirect, email, chat, or invoice).
- Receive the
payment.completedwebhook and verify its signature. - Re-fetch the transaction by ID to confirm status from the API.
- Fulfil and store both IDs for reconciliation and support.
Polapine exposes exactly this flow. Start no-code with Cash App Checkout, then move to the Cash App + Crypto Payment Links API when you are ready to automate.
Frequently Asked Questions
Does Cash App have a public API?
No. Cash App does not publish a standalone public API that lets arbitrary third parties move money directly. The supported developer route is Cash App Pay through Square (Block) APIs, and third-party orchestration layers can route Cash App acceptance through approved channel-partner connections.
How do developers integrate Cash App Pay?
Approved Square sellers integrate Cash App Pay using Square's Web Payments SDK on the front end and Square's Payments API on the back end, then handle payment status through Square webhooks. Businesses outside Square's accepted categories use a third-party orchestration API instead.
Can I get a Cash App API key?
You do not get a Cash App API key directly from Cash App. You authenticate against Square for Cash App Pay, or against an orchestration provider that issues its own API credentials and routes Cash App through approved partners.
What webhooks does a Cash App integration need?
At minimum you handle payment-completed, payment-failed, and payment-pending events so your system can trigger fulfilment, retries, and reconciliation. Orchestration providers expose these as a single webhook stream regardless of the underlying rail.
Is there a Cash App API for high-risk businesses?
Square restricts many high-risk categories, so those businesses cannot use Cash App Pay directly. A third-party orchestration provider with API access and approved channel-partner routing is the typical path, subject to underwriting.
Can I use my own provider keys with an orchestration API?
Yes. Businesses with an existing supported provider account can connect their own credentials and use the orchestration layer only for routing, observability, webhooks, and payment management.
How do I reconcile Cash App payments programmatically?
Store the provider transaction ID and your own order ID on each payment, listen for status webhooks, and reconcile against the orchestration API's transaction records. Keep both IDs so support and dispute handling can match a payment to an order.
Does Polapine hold funds during API settlement?
No. Polapine is an API connector and orchestration layer. Settlement happens through the underlying payment provider or approved channel partner; Polapine does not take custody of merchant balances.
Related guides
Build on the Cash App API route
Pilot with a hosted link, then graduate the same approved route into webhooks and API automation.
Sign Up Now