Confirm Payment Intent Element
Confirm a Payment Intent with an Element
Last verified 2026-09-24
Is this helpful?
stripe.confirmPaymentIntent(clientSecret: string, element: Element, data?: object) confirmPaymentIntent has been deprecated. Going forward, if you wish to confirm on the client without handling next actions, simply pass {handleActions: false} as a third argument to confirmCardPayment. While we have no plans to ever remove support for confirmPaymentIntent, we think that explicitly opting out of next action handling is easier to understand and will better convey what the method is doing. Use stripe.confirmPaymentIntent(clientSecret, element, data) when the customer submits your payment form. It will gather payment information from element, along with any other data you provide, and confirm the PaymentIntent. Only use this method if you want to handle next actions yourself. Otherwise, use stripe.handleCardPayment. > Note that stripe.confirmPaymentIntent may take several seconds to complete. > During that time, you should disable your form from being resubmitted and show a waiting indicator like a spinner. > If you receive an error result, you should be sure to show that error to the customer, re-enable the form, and hide the waiting indicator. - clientSecret The client secret of the PaymentIntent to confirm. - element An Element that will be used to create a payment method. - data Data to be sent with the request. It can contain the following parameters - return_url If you are handling next actions yourself, pass in a return_url. If the subsequent action is redirect_to_url, this URL will be used on the return path for the redirect. - payment_method_data Use this parameter to supply additional data relevant to the payment method, such as billing details. - billing_details The billing details associated with the card. - shipping The shipping details for the payment, if collected. - receipt_email Email address that the receipt for the resulting payment will be sent to. - setup_future_usage Indicates that you intend to make future payments with this PaymentIntent's payment method. If present, the PaymentMethod used with this PaymentIntent can be attached to a Customer, even after the transaction completes. Use on_session if you intend to only reuse the PaymentMethod when your customer is present in your checkout flow. Use off_session if your customer may or may not be in your checkout flow. See saving card details after a payment to learn more. Stripe uses setup_future_usage to dynamically optimize your payment flow and comply with regional legislation and network rules. For example, if your customer is impacted by SCA, using off_session will ensure that they are authenticated while processing this PaymentIntent. You will then be able to collect off-session payments for this customer. ### Example title Confirm a PaymentIntent Is this helpful?