How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Cash App Payments API

The payments API from Cash App — 6 operation(s) for payments.

Cash App Payments API is one of 19 APIs that Cash App publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Payments. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 7 operations across 6 paths, and defines 27 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against 2 base URLs: https://api.cash.app/network/v1, https://sandbox.api.cash.app/network/v1.

7 operations 6 paths 27 schemas 2 GET5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.cash.app/network/v1
Resource Areas
1

Paths & Operations 7

Across 6 paths, the API surfaces 7 operations — 2 GET, 5 POST. Each is listed below with its method, path, parameters, and response codes.

payments 7
GET
/payments
List payments
list-payments 9 params → 200400
POST
/payments
Create payment
create-payment 4 params body → 201400
GET
/payments/{payment_id}
Retrieve payment
retrieve-payment 5 params → 200404
POST
/payments/{payment_id}/authorizations
Create incremental authorization
create-payment-authorization 5 params body → 201400404
POST
/payments/{payment_id}/capture
Capture payment
capture-payment 5 params body → 200400
POST
/payments/{payment_id}/void
Void payment
void-payment 5 params → 200400404
POST
/payments/void-by-idempotency-key
Void payment by idempotency key
void-payment-by-idempotency-key 4 params body → 200400

Schemas 27

The contract defines 27 schemas that model the data the API accepts and returns. The most detailed are Payment (22 properties), Authorization (10 properties), PaymentsPostRequestBodyContentApplicationJsonSchemaPayment (8 properties), PaymentEnrichments (4 properties). Each schema is shown below with its type and property counts.

PaymentEnrichmentsInitiationActor
string
The party who initiated the payment. - CUSTOMER - MERCHANT
Create-payment-authorizationRequestBadRequestError
object
2 properties 1 required
PaymentsPostRequestBodyContentApplicationJsonSchemaPayment
object
Data about the payment to create.
8 properties 4 required
Payment
object
22 properties 13 required
Payments_retrieve-payment_Response_200
object
1 property 1 required
FeeRate
object
A fee rate contains the components of a fee charged by Cash App to partners for a given payment.
2 properties
PaymentEnrichments
object
Describes optional fields beyond core payment information to supplement payment processing. Enrichments provide additional context about a payment, which can i…
4 properties
Payments_void-payment_Response_200
object
1 property 1 required
Error
object
Represents an error encountered during a request to the API.
4 properties 2 required
PaymentStatus
string
The step of the payment processing lifecycle that this payment is currently at. - AUTHORIZED - CAPTURED - VOIDED - DECLINED
Retrieve-paymentRequestNotFoundError
object
1 property 1 required
Currency
string
Indicates the country associated with an entity. Values are from the [ISO-4217 Alpha-3](https://www.iso.org/iso-4217-currency-codes.html) specification. Curren…
Payments_create-payment-authorization_Response_201
object
1 property 1 required
ErrorCategory
string
The high-level reason the error occurred.
Payments_create-payment_Response_201
object
1 property
IdempotencyKey
string
A unique identifier which can be used by Cash App to de-duplicate retries of this request, making it idempotent. For more information, see [Idempotency](/cash-…
PaymentEnrichmentsRestrictedCategoriesItems
string
Payments_list-payments_Response_200
object
2 properties 1 required
ErrorResponse
object
1 property 1 required
AuthorizationStatus
string
The step of the authorization processing lifecycle that this authorization is currently at. Allowed values: - AUTHORIZED - DECLINED
Metadata
object
Freeform key-value pairs of arbitrary data associated with this resource. Keys and values must be passed as strings and not contain any personally identifiable…
Authorization
object
Represents an authorization update for a payment
10 properties 7 required
Payments_void-payment-by-idempotency-key_Response_200
object
1 property 1 required
Payments_capture-payment_Response_200
object
1 property 1 required
PaymentEnrichmentsInitiation
object
If present, provides information about transaction initiation.
1 property 1 required
Create-paymentRequestBadRequestError
object
2 properties 1 required
PaymentsPaymentIdAuthorizationsPostRequestBodyContentApplicationJsonSchemaAuthorization
object
Details about the authorization to create.
4 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cash-app-payments-api-openapi.yml Raw ↑

Other APIs Cash App publishes across the network.

Cash App Add Cash App Pay To Your Site API
Cash App API Keys API
Cash App Balances API
Cash App Billing Agreements (Deprecated) API
Cash App Brands API
Cash App Customer Request API
Cash App Customers API
Cash App App Default API
Cash App Disputes API
Cash App Fee Plans API
Cash App Grants Afterpay API
Cash App Merchants API
Where this information came from

This is an independent, third-party profile of Cash App Payments API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.