> This page is for Cash App Pay Partner API.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.cash.app/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.cash.app/_mcp/server.

# Incremental Authorization

Incremental authorization lets merchants request an increase to the authorized amount for a pending Cash App Pay payment. If the payment is eligible and the Cash App customer has additional funds available, Cash App increases the authorization to the higher amount requested by the merchant.

For example, a customer authorizes \$20 for a food delivery order. During fulfillment, they add items worth \$10. Instead of creating a new payment, you can increase the existing authorization to \$30.

> **Note**
>
> To implement incremental authorization, you must use deferred capture (separate authorization and capture steps). Contact the [Cash App Pay Partner Engineering Team](https://afterpay.formstack.com/forms/global_merchant_technical_support) to request access.

Incremental authorization is available for both one-time and on file payments.

## Set up incremental authorization

### Step 1: Create a payment authorization

Call the Create Payment endpoint [(/v1/payments)](/cash-app-pay-partner-api/api-reference/network-api/create-payment) to create a payment authorization. Set `capture` to `false`.

### Step 2: Update the payment authorization

Call the Create Incremental Authorization endpoint [(v1/payments/\{payment_id}/authorizations)](/cash-app-pay-partner-api/api-reference/network-api/create-payment-authorization) with the updated amount. `amount` must be greater than or equal to the current authorized amount, and must follow the limits described above.

When the authorized amount is updated, the customer is notified via email, SMS, or push notification.

### Step 3: Capture payment

Within 7 days of creating the payment authorization, call the Capture Payment endpoint [(/v1/payments/\{payment_id}/capture)](/cash-app-pay-partner-api/api-reference/network-api/capture-payment) to capture the final payment.

> **Note**
>
> You can also void the payment by calling [/v1/payments/\{payment_id}/void](/cash-app-pay-partner-api/api-reference/network-api/void-payment).

```mermaid
flowchart TD
    A[Start] --> C[One-time Payment Grant]
    A --> D[On File Payment Grant]
    
    C --> E[Create Payment]
    D --> E
    
    E --> F[Create Incremental Authorization]
    
    F --> G[Capture Payment]
    
    G --> H[Complete]
    
    style A fill:#ffffff,stroke:#000000
    style C fill:#ffffff,stroke:#000000
    style D fill:#ffffff,stroke:#000000
    style E fill:#ffffff,stroke:#000000
    style F fill:#ffffff,stroke:#000000
    style G fill:#ffffff,stroke:#000000
    style H fill:#ffffff,stroke:#000000
```

## Limits

* You can incrementally increase the amount up to 10 times per payment
* Authorization increases are limited to \$500 or 500% of the previous amount, whichever is higher
* Increases must be captured within the expiration window of the original payment authorization (default 7 days)