To make integrations more resilient it's a best practice to have an explicit timeout configured for API endpoints.

To improve integration resilience, it’s a best practice to configure explicit timeouts for all API requests made to Klarna Network APIs.

All Klarna Network APIs enforce an idle timeout — a limit on how long a connection can remain open without returning data.

• Default idle timeout: 59 seconds
• Some API operations define shorter timeouts, which are specified in their individual API operation documentation.
• Note: An API request may take longer than 59 seconds if the connection remains active and data continues to be transferred. This situation is rare and should not be relied upon for normal operation.

If the timeout is reached before a response is returned, Klarna’s API responds with HTTP status code 500` and a structured error object indicating a timeout condition:

{
  "error_id": "8e3a4d0c-3b0a-4b1e-9a3e-2a2a1f2e4e77",
  "error_type": "TECHNICAL_ERROR",
  "error_code": "TIMEOUT",
  "error_message": "Request processing timeout."
}

Timed-out requests can be safely retried, following the recommendations outlined in the Idempotency documentation.