Create incremental authorization

Creates an authorization update for a payment. The authorization amount must be greater than or equal to the current authorized amount.

Use this endpoint for incremental authorization instead of overcapturing using the Capture payment endpoint. By creating additional payment authorizations exceeding the current authorized amount, you can request additional funds without risking the original amount being declined.

This endpoint is not rate limited.

Scopes: PAYMENTS_WRITE

Creates an authorization update for a payment. The authorization amount must be greater than or equal to the current authorized amount. Use this endpoint for incremental authorization instead of overcapturing using the Capture payment endpoint. By creating additional payment authorizations exceeding the current authorized amount, you can request additional funds without risking the original amount being declined. **This endpoint is not rate limited.** Scopes: `PAYMENTS_WRITE`

Path parameters

payment_idstringRequired

Request

This endpoint expects an object.

idempotency_keystringRequired>=1 character<=64 characters

A unique identifier which can be used by Cash App to de-duplicate retries of this request, making it idempotent. Learn more about idempotency in the API.

authorizationobjectRequired

Details about the authorization to create.

Response

Created

authorizationobject

Represents an authorization update for a payment

1	curl -X POST https://api.cash.app/network/v1/payments/payment_id/authorizations \
2	-H "Accept: Accept" \
3	-H "X-Region: X-Region" \
4	-H "X-Signature: X-Signature" \
5	-H "User-Agent: User-Agent" \
6	-H "Content-Type: application/json" \
7	-d '{
8	"idempotency_key": "e345c3fb-1caa-46fd-b0d3-aa6c7b00ab19",
9	"authorization": {
10	"amount": 100,
11	"currency": "USD"
12	}
13	}'

1	{
2	"authorization": {
3	"id": "string",
4	"amount": 1,
5	"currency": "USD",
6	"status": "AUTHORIZED",
7	"created_at": "2024-01-15T09:30:00Z",
8	"payment_id": "string",
9	"previous_amount": 1,
10	"reference_id": "string",
11	"metadata": {},
12	"decline_errors": [
13	{
14	"category": "API_ERROR",
15	"code": "MISSING_REQUIRED_FIELD",
16	"detail": "Missing required parameter.",
17	"field": "field_a[2].field_b"
18	}
19	]
20	}
21	}

Path parameters

Headers

Request

Response

Errors