Брз почеток со SDK

Објавено издание: SDK 0.1.3 е јавно достапен на npm. Инсталацијата не активира серверски функции.

1. Отворете Поставки → API Keys во одобрена продавница и изберете TEST. Чувајте го TEST клучот во серверска конфигурација.
2. На makeClient подолу доставете baseUrl како вистински API origin без патека, storeId, apiKey и environment: 'TEST'. Самото внесување на примерот не контактира сервис.
3. Повикајте client.products.list() за UUID на одобрен производ. Користете createTestCheckout(client, productId) за изолиран TEST линк. Individual TEST бара пазар; примерот користи AU како тест-контекст, а не LIVE одобрение.
4. Проверете го добиениот URL според конфигурираниот checkout origin пред да го предадете на прелистувачот.
5. Користете само TEST клучеви и измислени тест-податоци. TEST резултат не создава LIVE банкарска исплата или право на LIVE исполнување.

За одобрена LIVE интеграција користете checkout.createHosted, а потоа серверска потврда. Не менувајте само ознака на средина: користете соодветен LIVE клуч и одделно проверени сметка, производ и пазар.

Пример со серверски TEST клуч од јавниот npm пакет

Инсталирајте @kordiva/sdk@0.1.3 со pnpm add @kordiva/sdk@0.1.3. Користете го само на заштитен Node backend со сопствен TEST Store API клуч и одобрен производ:

Тестираниот TypeScript пример подолу ги извезува makeClient(config) и createTestCheckout(client, productId). Прво повикајте client.products.list({ limit: 20 }) за читање каталог, па документираниот TEST метод client.checkout.createTest({ productId, testSaleMarket: 'AU' }) со одобрен производ. Заедничкиот код-пример исто така користи AU; друг пазар избирајте само ако е поддржан и одобрен за вашата TEST продавница. Чувајте го линкот приватно; ниту еден TEST пазар не значи LIVE одобрение.

products.list го чита каталогот; createTest создава изолиран TEST линк. Тоа не одобрува LIVE продажби или исплати. Не објавувајте Store API клучеви или приватни checkout URL токени. Во LIVE одделно овластениот backend користи checkout.createHosted и payments.confirm, никогаш TEST клуч.

typescript.ts

import { Kordiva } from "@kordiva/sdk";
import type { KordivaOptions } from "@kordiva/sdk";
/** Configuration comes from protected backend configuration, never NEXT_PUBLIC_* or VITE_*. */
export function makeClient(config: KordivaOptions): Kordiva {
  return new Kordiva(config);
}
export async function createTestCheckout(client: Kordiva, productId: string) {
  return client.checkout.createTest({ productId, testSaleMarket: "AU" });
}

Поврзани водичи

SDK · Checkout · Безбедност · API

Business integration

Recurring checkout and subscription reads → Signed Business events → Raw-body verification → Business refunds → API reference. Individual MoR follows its separate refund process.