Skip to main content
Klarna is a buy now, pay later option that lets eligible buyers split purchases into installments.

​
Setup

Follow the Stripe setup instructions before configuring Klarna. After setting up your Stripe account, make sure Klarna is enabled as a payment method in Stripe. For shared APM credentials and payment IDs, see Stripe APM credentials.

​
Capabilities

​
Supported countries

​
Supported currencies

​
Webhooks

Klarna payments and refunds can be completed asynchronously, so webhooks must be configured to update the status of transactions. Webhooks are configured in the Stripe Dashboard within Developer Settings under Webhooks. The Klarna connector relies on the following Stripe webhooks:
  • charge.expired
  • charge.refund.updated
  • charge.refunded
  • payment_intent.succeeded
  • payment_intent.amount_capturable_updated
  • payment_intent.payment_failed
  • payment_intent.partially_funded
  • payment_intent.canceled
  • checkout.session.async_payment_succeeded

​
Integration

The default integration for Klarna via Stripe uses a redirect to a payments page hosted by Gr4vy.

​
Redirect integration

Start by creating a new transaction with the following required fields. 
var transaction = await client.Transactions.CreateAsync(
	transactionCreate: new TransactionCreate()
	{
		Amount = 1299,
		Currency = "USD",
		Country = "US",
		PaymentMethod =
			TransactionCreatePaymentMethod.CreateRedirectPaymentMethodCreate(
				new RedirectPaymentMethodCreate()
				{
					Method = "klarna",
					Country = "US",
					Currency = "USD",
					RedirectUrl = "https://example.com/callback",
				}
			),
	}
);
After the transaction is created, the API response includes a payment_method.approval_url and the status is set to buyer_approval_pending. 
{
	"type": "transaction",
	"id": "ea1efdd0-20f9-44d9-9b0b-0a3d71e9b625",
	"payment_method": {
		"type": "payment-method",
		"approval_url": "https://cdn.gr4vy.com/connectors/..."
	},
	"method": "klarna"
}
Redirect the buyer to the approval_url (open in a browser or Webview), where they can complete the payment. Once the buyer completes the payment, the transaction progresses to an authorization_succeeded or capture_succeeded state.

​
Direct integration

If you intend to use your own hosted page, you can include an integration_client parameter set to web, ios or android when creating a new transaction. 
var transaction = await client.Transactions.CreateAsync(
	transactionCreate: new TransactionCreate()
	{
		Amount = 1299,
		Currency = "USD",
		Country = "US",
		IntegrationClient = "ios",
		PaymentMethod =
			TransactionCreatePaymentMethod.CreateRedirectPaymentMethodCreate(
				new RedirectPaymentMethodCreate()
				{
					Method = "klarna",
					Country = "US",
					Currency = "USD",
					RedirectUrl = "myapp://callback",
				}
			),
	}
);
After the transaction is created, the API response includes a session_token. You use this token with the session endpoint to retrieve the session data for the transaction and build a custom page. 
POST /transactions/:transaction_id/session?token=:session_token

{
  "session_data": {
    "publishableKey": "some_key",
    "clientSecret": "client_secret",
    "returnUrl": "url_to_return_after_payment_completed"
  },
  "default_completion_url": "https://example.com/callback",
  "integration_client": "ios"
}

​
Mobile redirect integration completion

On mobile integrations you should send a GET request to the default_completion_url provided in the session response.

​
Payment IDs

When creating the transaction, the payment_service_transaction_id is the client secret, and in the extra_xids field you can find the payment intent ID as payment_id. After the transaction is approved by the user, the payment_service_transaction_id is updated to the payment intent ID.