Развоен SDK

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

Kordiva SDK ја поврзува вашата веб-страница со постојните API за каталог и наплата. Вашиот сервер го чува клучот за продавницата; прелистувачот добива URL за наплата. Податоците за картичката остануваат во постојниот Kordiva/Stripe хостиран тек.

Верзија 0.1.3 е јавно достапна на npm. Секој може да ги инсталира објавените пакети без токен за преземање; за заштитените Kordiva API операции сè уште се потребни посебен TEST или LIVE клуч за продавницата и соодветно одобрение.

Пакет	Каде работи	Намена
@kordiva/sdk	Сервер, Node 20+	Каталог, хостирана/периодична наплата, LIVE потврда, Business претплати и проверка на merchant настани
@kordiva/checkout	Прелистувач или сервер	Проверка на точен дозволен origin и пренасочување кон наплата
@kordiva/react	React 18.2/19, Next клиентски компоненти	Пристапно копче што го повикува вашиот сервер

Кој начин на интеграција да го изберете?

Вашата веб-страница	Препорачана интеграција	Store API клуч?
Kordiva CMS тема	Вградена продавница	Не
WordPress / HTML / статичен линк	Постоен Kordiva Checkout Link	Не
Сопствен Node.js backend	@kordiva/sdk водич	Да, само на сервер
React / Next.js	@kordiva/react водич + checkout helper; SDK на backend	Да, само на сервер
Обичен JavaScript	@kordiva/checkout водич и заштитен backend	Само за заштитен Store API

SDK е изборен. Не ги заменува CMS продавниците, Checkout Links, постојниот директен HTTP API, Booking или Rent-a-Car. Може истовремено да користите Kordiva продавница и SDK. Пакетите не создаваат нов платежен процесор и не ги менуваат Business Stripe Connect или Individual Full Merchant of Record обврските.

Потврда на плаќање: Kordiva ги обработува Stripe известувањата на свој сервер. Вашиот backend го проверува LIVE payments.confirm() пред да покаже успех; URL за враќање не е доказ. Не треба посебен merchant Stripe webhook за стандардна Kordiva хостирана наплата, а SDK 0.1.3 додава потпишани Business настани преку одделниот merchant-webhooks извоз. Како да потврдите плаќање.

Посебни водичи за секој npm пакет

Изберете го пакетот: @kordiva/sdk за Node.js, @kordiva/checkout за проверка на URL или @kordiva/react за React/Next.js. Секој водич ја објаснува инсталацијата, функциите, интеграцијата, TEST/LIVE ограничувањата и проверката на плаќање.

Јавна инсталација од npm

pnpm add @kordiva/sdk@0.1.3
pnpm add @kordiva/react@0.1.3 @kordiva/checkout@0.1.3

Користете @kordiva/sdk само во Node.js серверски код. React и checkout компонентите не примаат Store API клучеви. Продолжете со инсталација, React пример и WordPress/HTML пример.

1. Изберете Business или Individual и завршете ја соодветната апликација/проверка.
2. Прочитајте инсталација и извршете го TEST почетокот.
3. Додајте серверска адреса со ваша автентикација; проверете безбедност.
4. Активирајте LIVE само по потврда на сметката, производот и купувачкиот пазар од Kordiva.

Сите активни платени Business/Sole Trader планови — Basic, Professional и Enterprise — вклучуваат API и SDK интеграција. Individual Creator (бесплатен), Pro и одобрените Scale конфигурации вклучуваат API за сопствени веб-страници и апликации, според сопствените правила за одобрување и средина. Preview не дава автоматски LIVE API пристап. Individual продажбите остануваат ограничени на одобрени дигитални производи, со Kordiva како Full Merchant of Record и неговите контроли за хостирана наплата, даноци, рефунди, спорови, резерви и исплати.

Апликациите ги опфаќаат MK, AL, RS и BA за двата модела; тоа не докажува еднакви LIVE можности. Individual останува само за одобрена еднократна дигитална продажба, со рефундации, резерви и исплати контролирани од Kordiva. Booking и Rent-a-Car се одделни.

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

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.