Create a Setup Intent

​

Creates a setup intent.

Body·SetupIntentCreateRequest
required
application/json
  • currency
    Type: string · CurrencyCode
    required

    ISO 4217 currency codes (alpha3) supported for payments

  • confirm
    Type: boolean

    Set to true to attempt to confirm this PaymentIntent immediately. This parameter defaults to false. When creating and confirming a PaymentIntent at the same time, you can also provide the parameters available in the Confirm API.

  • off_session
    Type: string | null
    max length:  
    100    enum

    Use this parameter in scenarios where you collect card details and charge them later. This parameter can only be used with confirm=true.

    values
    • one_off
    • recurring
Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/v1/setup_intents
curl https://api.paypercut.io/v1/setup_intents \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "currency": "EUR",
  "confirm": true,
  "off_session": "one_off"
}'

{
  "currency": "EUR",
  "usage": "string",
  "payment_method": "01K688H80Z3199KETHDJ4ZAFPS",
  "x-expansionResources": "01K688H80Z3199KETHDJ4ZAFPS",
  "id": "21210021c2855007efa2d657018",
  "status": "canceled",
  "livemode": true,
  "created": "2026-04-17T20:01:58.674Z"
}

Setup Intent Details