Captures

Captures a payment

Captures a payment intent that has previously been created but not yet refunded or reversed. You can capture the full amount or a partial amount.

post/payment-intents/{paymentIntentId}/captures

Request

Path parameters

paymentIntentIdstring nullable required

The unique identifier of the payment intent.

Headers

versionstring date required

The API version with format yyyy-mm-dd. The current version is 2026-02-27.

Request body

amountinteger required

The capture amount. You can capture a full or partial amount. Multiple partial captures can be made on the same total.

tipsAmountinteger nullable

The tip amount.

Example request

{
  "amount": 2000
}

Response

OK

messagestring nullable

The description of the operation.

captureIdstring nullable

The unique identifier for the capture.

Example response

{
  "message": "Demo capture",
  "captureId": "cp_itIiJMEAvES3ynYF_Yhs2g"
}

Changes

No recorded changes to this operation across all 1 revision of this API.