Cancel a Payment Intent

​

Cancels a Payment Intent that is no longer needed.

You can cancel a Payment Intent while it is waiting for a payment method, confirmation, customer action, or manual capture. After cancellation, no additional charges are made and later lifecycle operations on the Payment Intent fail.

If the Payment Intent is in requires_capture, Paypercut reverses the remaining authorization and sets amount_capturable to zero.

Related guide: Payment Intents

Path Parameters
  • id
    Type: string
    max length:  
    200
    required
Query Parameters
  • expand
    Type: array string[]
Body·
required
application/json
  • cancellation_reason
    Type: string | null · enum

    Reason for canceling this PaymentIntent. Possible values are: duplicate, fraudulent, requested_by_customer, or abandoned

    values
    • abandoned
    • duplicate
    • fraudulent
    • requested_by_customer
Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/v1/payment_intents/{id}/cancel
curl 'https://api.paypercut.io/v1/payment_intents/{id}/cancel' \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "cancellation_reason": "abandoned"
}'

{
  "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