@kordiva/sdk — Node.js серверски клиент

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

@kordiva/sdk

Јавен npm пакет · TEST/LIVE правила · API референца

За Node.js backend што чита производи и отвора Kordiva наплата. Пакетот не се користи во прелистувач. За API пристап е потребен соодветен Store API клуч од CMS → Settings → API Keys и одобрена продавница.

pnpm add @kordiva/[email protected]

TEST пример

import { Kordiva } from "@kordiva/sdk";
const client = new Kordiva({
  baseUrl: process.env.KORDIVA_API_ORIGIN!,
  storeId: process.env.KORDIVA_STORE_ID!,
  apiKey: process.env.KORDIVA_TEST_API_KEY!,
  environment: "TEST",
});
const products = await client.products.list({ limit: 20 });
const productId = products.items[0]?.id;
if (!productId) throw new Error("No approved products");
const checkout = await client.checkout.createTest({
  productId,
  testSaleMarket: "AU", // само дозволен TEST пазар
});

LIVE и успешна наплата

Со посебен LIVE клуч повикајте checkout.createHosted({ lineItems, idempotencyKey }) од вашиот заштитен backend. Во трајна база зачувајте sessionId, idempotencyKey и сопственост на купувачот/кошничката. Потоа серверски повикајте:

const payment = await live.payments.confirm({
  sessionId: savedSessionId,
  idempotencyKey: savedCartAttemptKey,
});
const paid = payment.status === "paid" &&
  payment.isPaid === true && Boolean(payment.orderId);

live, savedSessionId и savedCartAttemptKey се вредности од вашата овластена LIVE серверска интеграција, не од URL на купувачот. Враќање од checkout не е доказ за уплата. Не испорачувајте додека плаќањето и потребните дозволи не се потврдени. TEST createTest() не користи LIVE payments.confirm().

Достапни се и products.get(), categories.list(), attributes.list() и Business shippingMethods.list(). Извозот @kordiva/sdk/webhooks проверува одделен agentic order потпис, не Stripe и не општ merchant payment webhook. Stripe webhook го обработува Kordiva.

Прочитајте checkout пример, проверка на плаќање, автентикација и безбедност.

Business integration

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

0.1.3 also exposes client.subscriptions.get(id), client.subscriptions.list({ customerRef: "user_123" }) and client.checkout.createSubscription(input). Business HMAC verification uses verifyMerchantWebhook from @kordiva/sdk/merchant-webhooks; the P-256 agentic verifier above remains separate. The SDK has no public refund/change/cancel mutation.