Klarna Partner Product API - Interoperability (release/4)

Download OpenAPI specification:Download

Authentication

klarna_api_key

Use the Klarna API key as HTTP Basic Authentication credentials

Security Scheme Type API Key
Header parameter name: Authorization

Interoperability API

Interoperability refers to the ability of Klarna's full product suite to work seamlessly across multiple integration paths.

Returns interoperability information

Returns interoperability information

Request
Security:
query Parameters
interoperability_token
string (InteroperabilityToken)

Token signed by Klarna with interoperability information

country
string (Country) ^[A-Za-z]{2}$

The country code of the payment.

Example: country=US
currency
required
string (Currency) ^[A-Za-z]{3}$

The currency of the payment.

Example: currency=USD
payment_amount
integer <int64> (PaymentAmount) [ 1 .. 2147483647 ]

The amount of the payment.

Example: payment_amount=2000
merchant_reference
string (MerchantReference) [ 1 .. 256 ] characters

The merchant reference of the payment.

Example: merchant_reference=merchant-order-9876
platform_reference
string (PlatformReference) [ 1 .. 256 ] characters

The platform reference of the payment.

Example: platform_reference=paltform-order-9876
Responses
200

Interoperability information

400

Bad Request, there was an error in the input of the request. The request can not be retried without modifications.

401

Unauthorized, the request was not authorized.

429

Too Many Requests, the request was rate limited.

500

Internal Server Error, there was an unexpected error in the API.

503

Service Temporarily Unavailable, the system is temporarily unavailable to process the request.

get/v1/interoperability
Request samples
curl -i -X GET \
  'https://api-global.klarna.com/v1/interoperability?interoperability_token=string&country=US&currency=USD&payment_amount=2000&merchant_reference=merchant-order-9876&platform_reference=paltform-order-9876' \
  -H 'Authorization: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "shopping_session_id": "krn:shopping:eu1:live:session:b1de90a1-1069-414c-a119-2b8e68f9e252",
  • "payment_confirmation_token": "krn:payment:eu1:confirmation-token:e15432a5-ebcc-45bc-944c-e61399db597b",
  • "status": "PAYMENT_PENDING_CONFIRMATION"
}