The payments API is used to create a session to offer Klarna's payment methods as part of your checkout.
This is a community listing. If you own this API, you can request ownership.
npm install omnistream-sdkimport { OmniClient } from "omnistream-sdk";
const omni = new OmniClient({ token: process.env.OMNI_KEY! });
// One key reaches every API on the marketplace.
const data = await omni.call("klarna/cancelAuthorization");One install, one key - the same client calls every API on the marketplace.
Cancel an existing authorization
Generate a consumer token
Create a new order
Create a new payment session
Read an existing payment session
Update an existing payment session
/**
* KlarnaPaymentsAPIV1 - generated by OmniStream from Klarna Payments API V1's OpenAPI spec.
* One typed method per endpoint. A single Omni key reaches the API.
*/
const DEFAULT_BASE = "https://grid.skinvaults.online/v1/proxy/klarna";
export class KlarnaPaymentsAPIV1Error extends Error {
status: number;
code?: string;
constructor(status: number, code: string | undefined, message?: string) {
super(message || `KlarnaPaymentsAPIV1 error ${status}`);
this.name = "KlarnaPaymentsAPIV1Error";
this.status = status;
this.code = code;
}
}
export interface KlarnaPaymentsAPIV1Options {
baseUrl?: string;
fetch?: typeof fetch;
timeoutMs?: number;
}
export class KlarnaPaymentsAPIV1 {
/** @param token Your OmniStream key (one key for every API). */
constructor(private token: string, private opts: KlarnaPaymentsAPIV1Options = {}) {
if (!token) throw new Error("KlarnaPaymentsAPIV1: token is required");
}
rateLimit: { remainingMinute?: number; remainingDay?: number } | null = null;
private async _request(method: string, path: string, { params, body }: { params?: Record<string, unknown>; body?: unknown } = {}): Promise<any> {
const f = this.opts.fetch ?? globalThis.fetch;
const url = new URL((this.opts.baseUrl ?? DEFAULT_BASE).replace(/\/+$/, "") + path);
if (params) for (const [k, v] of Object.entries(params)) if (v != null) url.searchParams.set(k, String(v));
const headers: Record<string, string> = { "x-omni-key": this.token };
if (body !== undefined) headers["content-type"] = "application/json";
const res = await f(url, { method, headers, body: body !== undefined ? JSON.stringify(body) : undefined });
this.rateLimit = {
remainingMinute: Number(res.headers.get("x-ratelimit-remaining-minute")) || undefined,
remainingDay: Number(res.headers.get("x-ratelimit-remaining-day")) || undefined,
};
const data = await res.json().catch(() => ({}));
if (!res.ok) throw new KlarnaPaymentsAPIV1Error(res.status, data?.error?.code, data?.error?.message);
return data.data ?? data;
}
/** Cancel an existing authorization */
cancelAuthorization(params: { "authorizationToken": string }): Promise<any> {
return this._request("DELETE", "/payments/v1/authorizations/{authorizationToken}", { params });
}
/** Generate a consumer token */
purchaseToken(body: unknown, params: { "authorizationToken": string }): Promise<any> {
return this._request("POST", "/payments/v1/authorizations/{authorizationToken}/customer-token", { body, params });
}
/** Create a new order */
createOrder(body: unknown, params: { "authorizationToken": string }): Promise<any> {
return this._request("POST", "/payments/v1/authorizations/{authorizationToken}/order", { body, params });
}
/** Create a new payment session */
createCreditSession(body: unknown): Promise<any> {
return this._request("POST", "/payments/v1/sessions", { body });
}
/** Read an existing payment session */
readCreditSession(params: { "session_id": string }): Promise<any> {
return this._request("GET", "/payments/v1/sessions/{session_id}", { params });
}
/** Update an existing payment session */
updateCreditSession(body: unknown, params: { "session_id": string }): Promise<any> {
return this._request("POST", "/payments/v1/sessions/{session_id}", { body, params });
}
}
export default KlarnaPaymentsAPIV1;
No reviews yet. Be the first to rate this API.
No. Klarna Payments API V1 is included with your Omni key, so a single OmniStream key is enough to start calling it. There is no separate signup with the provider and no second key to manage.
The payments API is used to create a session to offer Klarna's payment methods as part of your checkout. It exposes 6 endpoints over DELETE, POST, GET, including DELETE /payments/v1/authorizations/{authorizationToken}, POST /payments/v1/authorizations/{authorizationToken}/customer-token, POST /payments/v1/authorizations/{authorizationToken}/order.
Install the OmniStream SDK for your language and call Klarna Payments API V1 through it. The client is generated from this API's OpenAPI spec, so parameters and responses are fully typed, and the same client also calls every other API in the marketplace.
You can start on the free plan. OmniStream charges for the unified SDK, key storage and proxy rather than for Klarna Payments API V1 itself.
ExchangeRate-API: Fetch the latest currency exchange rates via API. ExchangeRate-API is free and unlimited.