## Handle card setup with an Element

`stripe.handleCardSetup(clientSecret: string, element: Element, data?: object)`

*`handleCardSetup` has been renamed to [confirmCardSetup](#stripe_confirm_card_setup). In addition to the rename, we have slightly modified the arguments. These changes do not affect the behavior of the method. While we have no plans to ever remove support for `handleCardSetup`, we think the new name and arguments are easier to understand and better convey what the method is doing.*

Use `stripe.handleCardSetup(clientSecret, element, data?)` in the [Setup Intents API flow](https://docs.stripe.com/payments/save-and-reuse.md) when the customer submits your payment form. It will gather payment information from the `element`, which can be a `card` or `cardNumber` element, along with any other data you provide. It will then confirm the `SetupIntent` and carry out 3DS or other `next_action`s if they are required.

> Note that `stripe.handleCardSetup` 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.
>
> Additionally, `stripe.handleCardSetup` may trigger a [3D Secure](https://docs.stripe.com/payments/3d-secure.md) authentication challenge.
> This will be shown in a modal dialog and may be confusing for customers using assistive technologies like screen readers.
> You should make your form accessible by ensuring that success or error messages are clearly read out after this method completes.

- `clientSecret`
The [client secret](https://docs.stripe.com/api/setup_intents/object.md#setup_intent_object-client_secret) of the `SetupIntent`.

- `element`
A `card` or `cardNumber` Element that will be used to create a payment method.

- `data`
Data to be sent with the request.

- `payment_method_data`
Use this parameter to supply additional data relevant to the payment method, such as billing details.

- `billing_details`
The [billing details](https://docs.stripe.com/api/payment_methods/create.md#create_payment_method-billing_details) associated with the card.

### Example

```javascript
const stripe = Stripe('pk_test_...');

const elements = stripe.elements();
const cardElement = elements.create('card');
cardElement.mount('#card-element');

const form = document.getElementById('payment-form');
form.addEventListener('submit', async (event) => {
  event.preventDefault();

  const {setupIntent, error} = await stripe.handleCardSetup(
    clientSecret,
    cardElement
  );

  if (error) {
    // Display error.message to your customer
  } else {
    // Handle successful setupIntent
  }
});
```