Klarna Docs - Using and placing orders with Klarna customer tokens

Using and placing orders with Klarna customer tokens

How to charge, update and read Klarna customer tokens

When you have a customer token on file, as described in the use case article for signing consumers up to tokens, you can use this token to create orders, read the token details, or update the status of the token.

For more information about the lifecycle of a token, read the in-depth article  here.

As a partner, you can get Klarna to do a few things with created customer tokens:

  1. Place new orders from a customer token.
  2. Update the status of a customer token.
  3. Check the status of a customer token.

The customer token is already associated with the necessary customer payment details to place an order. The only thing that you will need to do to place an order using an already created token is to populate the required information to issue the request.

From Klarna’s side a risk and fraud assessment is done when you attempt to create an order using a token. This is to ensure that we can offer the consumer the credit necessary for the amount they will be charged.

Order lines in the request to create an order using a customer token that relate to subscriptions are required to include the subscription object.  The subscription object is part of the order_line object.  This subscription object allows Klarna to make better underwriting decisions and provide the consumer with an enriched post-purchase user experience in Klarna touchpoints.

You are responsible for setting the logic of when new orders should be created using customer tokens. In case you, for example, are using customer tokens to charge your customers for recurring purchases, such as a subscription, you would have to trigger the creation of the orders using the customer token as per the subscription cadence using the create_customer_token_order request. The details for this request are described in the article on the place order from token call.

Should you issue a separate capture request in relation to orders that are created using a token AND should you provide order_lines in your capture  request, any order lines in the request that relate to subscriptions are required to include the subscription object.

All customer tokens have a status that is either active, cancelled or suspended. When a token is created, it is automatically set to ‘active’. To get more information about the full life cycle of a token and when the statuses are applied, please read this article.

As a partner, you can decide to cancel a Klarna customer token if you do not intend to use it anymore – e.g. if the customer has revoked a subscription. This is done by changing the status of the customer token to ‘cancelled’. This will make it unusable for future order creation.

You can read about the details on updating token calls here.

Should you have the need to check on the status of a customer token, you can leverage the read customer token details API request. To get more information about the full life cycle of a token and when the statuses are applied, please read this article.

  1. Be able to securely store the tokens.
  2. Be able to correctly map your customer to our customer token ID.
  3. Have logic on your side that tells you when to trigger purchases from a token.