## Confirm a Klarna payment

`stripe.confirmKlarnaPayment(clientSecret: string, data?: object, options?: object)`

Use `stripe.confirmKlarnaPayment` in the Klarna payment method creation flow when the customer submits your payment form. When called, it will confirm the [PaymentIntent](https://docs.stripe.com/api/payment_intents.md) with `data` you provide, and it will automatically redirect the customer to authorize the transaction. Once authorization is complete, the customer will be redirected back to your specified `return_url`.

When you confirm a `PaymentIntent`, it needs to have an attached [PaymentMethod](https://docs.stripe.com/api/payment_methods.md). In addition to confirming the `PaymentIntent`, this method can automatically create and attach a new `PaymentMethod` for you. If you have already attached a `PaymentMethod` you can call this method without needing to provide any additional data. These use cases are detailed in the sections that follow.

> Note that `stripe.confirmKlarnaPayment` 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](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-client_secret) of the `PaymentIntent`.

- `data`
Data to be sent with the request. Refer to the [Payment Intents API](https://docs.stripe.com/api/payment_intents/confirm.md) for a full list of parameters.

- `payment_method`
Either the `id` of an existing [PaymentMethod](https://docs.stripe.com/api/payment_methods.md), or an object containing data to create a `PaymentMethod` with. See the use case sections below for details.

- `return_url`
The url your customer will be directed to after they complete authentication.

- `options`
An options object to control the behavior of this method.

- `handleActions`
Set this to `false` if you want to [manually handle the authorization redirect](https://docs.stripe.com/payments/klarna/accept-a-payment.md#handle-redirect). Default is `true`.

### Without an existing payment method

Data argument properties:

- `return_url`
The url your customer will be directed to after they complete authentication.

### Example

```javascript
const stripe = await stripePromise;
const {error} = await stripe.confirmKlarnaPayment(clientSecret, {
  payment_method: {
    billing_details: {
      name: 'Jenny Rosen',
      email: 'jenny.rosen@example.com',
      address: {
        country: 'SE',
      },
    },
  },
  return_url: 'https://example.com/klarna/return',
});
if (error) {
  // Handle error
}
```

### With an existing payment method

Data argument properties:

- `payment_method`
The `id` of an existing `PaymentMethod`.

### Example

```javascript
const stripe = await stripePromise;
const {error} = await stripe.confirmKlarnaPayment(clientSecret, {
  payment_method: 'pm_12345',
  return_url: 'https://example.com/klarna/return',
});
if (error) {
  // Handle error
}
```

### With an attached PaymentMethod

### Example

```javascript
const stripe = await stripePromise;
const {error} = await stripe.confirmKlarnaPayment(clientSecret, {
  return_url: 'https://example.com/klarna/return',
});
if (error) {
  // Handle error
}
```

### With self collected data

Data argument properties:

- `payment_method`
Pass an object to confirm with the customer's email and billing country.

- `billing_details`
The customer's [billing_details](https://docs.stripe.com/api/payment_methods/create.md#create_payment_method-billing_details). `email` and `address.country` are required.

- `email`
The customer's email.

- `address`
The customer's billing address.

- `country`
The customer's billing country.

- `return_url`
The url your customer will be directed to after they complete authentication.

### Example

```javascript
const stripe = await stripePromise;
const {error} = await stripe.confirmKlarnaPayment(clientSecret, {
  payment_method: {
    billing_details: {
      email: 'jenny.rosen@example.com',
      address: {
        country: 'SE',
      },
    },
  },
  return_url: 'https://example.com/klarna/return',
});
if (error) {
  // Handle error
}
```