Capture a Payment Intent

​

Captures funds for a Payment Intent whose capture_method is manual and whose current status is requires_capture.

Use this endpoint after authorization succeeds and your system is ready to collect the funds, such as after inventory, fulfillment, or fraud checks complete. If amount_to_capture is omitted, Paypercut captures the full capturable amount. Pass final_capture=true when completing the authorization.

Uncaptured Payment Intents are automatically canceled after the authorization window expires.

Related guide: Payment Intents

Path Parameters
  • id
    Type: string
    max length:  
    200
    required
Query Parameters
  • expand
    Type: array string[]
Body·
required
application/json
  • amount_to_capture
    Type: integer · Format: int64

    Amount to capture from the Payment Intent. The value must be less than or equal to amount_capturable. If omitted, Paypercut captures the full capturable amount.

  • final_capture
    Type: boolean

    Indicates that this is the final capture for the authorization. Pass true when capturing a manually authorized Payment Intent.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/v1/payment_intents/{id}/capture
curl 'https://api.paypercut.io/v1/payment_intents/{id}/capture' \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "amount_to_capture": 100,
  "final_capture": true
}'

{
  "amount": 100,
  "payment_method": "01K688H80Z3199KETHDJ4ZAFPS",
  "customer": {
    "created": "2026-07-08T08:02:27.751Z",
    "livemode": true,
    "email": null,
    "name": null,
    "phone": null,
    "preferred_locales": [
      "string"
    ],
    "address": {
      "city": null,
      "country": null,
      "line1": null,
      "line2": null,
      "postal_code": null,
      "state": null
    },
    "invoice_settings": {
      "default_payment_method": "01K688H80Z3199KETHDJ4ZAFPS"
    },
    "id": "string"
  },
  "capture_method": "automatic",
  "on_behalf_of": "string",
  "statement_descriptor": null,
  "setup_future_usage": "off_session",
  "id": "21210021c2855007efa2d657018",
  "created": "2026-07-08T08:02:27.751Z",
  "currency": {
    "iso": "usd",
    "scale": 2
  },
  "status": "canceled",
  "metadata": {
    "additionalProperty": "string"
  },
  "amount_capturable": 100,
  "amount_received": 100,
  "updated": "2026-07-08T08:02:27.751Z",
  "livemode": true,
  "next_action": {
    "redirect_to_url": {
      "return_url": null,
      "url": null
    },
    "type": "string",
    "three_d_secure": {
      "flow": "frictionless",
      "status_url": "https://api.yourco.com/v1/payment_intents/pi_123",
      "return_url": null,
      "message": {
        "allowed_origins": [
          "https://merchant.example.com"
        ]
      },
      "hint": {
        "scheme": "visa",
        "version": "2.2.0"
      },
      "idempotency_key": "string"
    }
  },
  "latest_payment": "01K755J9SV2364REVHB915Z2FW",
  "cancellation_reason": "abandoned",
  "canceled_at": null
}

Payment Intent Details