Setup Intents Create

Saves a buyer's payment method for later without charging it. Pass a `confirmation_token` for a method the buyer just supplied through the payment elements in setup mode, or a `payment_method_id` already on file to re-verify it. The response is the setup intent as created, not i…

मूल्य

मुफ़्त Action

एकीकृत भुगतान

अभी समर्थित नहीं

• emailstring or null
  Overrides the buyer email carried on the confirmation token, resolving or creating the user the method belongs to. Ignored unless `confirmation_token` is provided, and when the token was created by a signed-in buyer or the caller is the buyer.
• intentstring

  आवश्यक
  The original user request that led to this tool call. Copy it verbatim when available.
• purposestring or null
  What the saved payment method will pay for. Set to `ads_billing` when saving a card to pay for Whop Ads on `account_id`: the card is verified by Whop Ads, the merchant that charges it, which helps minimize security declines on ad payments, and it requires `ad_campaign:create` on…
• currencystring or null
  The currency the saved payment method will be used with, as a lowercase ISO 4217 code. Controls which currency-specific payment methods are available. Defaults to `usd`.
• metadataobject or null
  Custom metadata to attach to the setup intent. Returned on the setup intent and its webhooks.
• intent_idstring

  आवश्यक
  A UUID for the user turn that caused this call. Generate it once per user message and reuse it for every tool call made to fulfill that message. Never derive it from the intent text.
• account_idstring
  The account to save the payment method for, prefixed `biz_`.
• return_urlstring or null
  Where the buyer continues after completing an off-site step. An absolute https URL without credentials, at most 2,048 characters.
• three_ds_levelstring or null
  3D Secure behavior for supported on-session card payments. `mandate_challenge` requires a 3DS challenge before payment processing; `mandate_if_required` mandates a challenge only when the payment processor requires it; `frictionless_if_required` uses the regular frictionless 3DS…
• idempotency_keystring
  Caller-chosen stable retry key. Required when executing with a confirmation token; reuse the same key when retrying. The native API replays completed requests and rejects requests still in flight.
• payment_method_idstring or null
  An existing payment method to re-verify and save, prefixed `payt_`. Provide this or `confirmation_token`, not both. Not available to a buyer credential.
• confirmation_tokenstring or null
  A confirmation token describing a payment method the buyer just supplied, collected by the payment elements in setup mode. Provide this or `payment_method_id`, not both. The buyer is resolved from the token's billing email, or from `email`, and may still have a step to complete…

कोई समीक्षित संरचित आउटपुट सारांश उपलब्ध नहीं है।

अभी कोई सत्यापित संबंधित उपयोग मामला लिंक नहीं है।