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.
To implement incremental authorization, you must use deferred capture (separate authorization and capture steps). Contact the Cash App Pay Partner Engineering Team to request access.
Incremental authorization is available for both one-time and on file payments.
Call the Create Payment endpoint (/v1/payments) to create a payment authorization. Set capture to false.
Call the Create Incremental Authorization endpoint (v1/payments/{payment_id}/authorizations) 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.
Within 7 days of creating the payment authorization, call the Capture Payment endpoint (/v1/payments/{payment_id}/capture) to capture the final payment.
You can also void the payment by calling /v1/payments/{payment_id}/void.