Прескокни до содржината
Kordiva Docs

SDK инсталација

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

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

Инсталација со pnpm

Дел „Инсталација со pnpm“

Јавно достапни пакети 0.1.3: @kordiva/sdk, @kordiva/checkout и @kordiva/react.

  1. Користете Node 20+ за серверскиот SDK. За React компонентата потребен е React 18.2 или 19.
  2. Инсталирајте го серверскиот клиент во backend апликацијата:
Терминал
pnpm add @kordiva/[email protected]
  1. За React пренасочување кон наплата, инсталирајте:
Терминал
pnpm add @kordiva/[email protected] @kordiva/[email protected]

Користете го официјалниот јавен npm регистар. За преземање јавен пакет не се потребни токен, Kordiva претплата или Store API клуч. Отстранете стар @kordiva:registry запис што упатува кон приватен регистар. Не ставајте Store API клучеви во .npmrc.

Овластете ја интеграцијата

Дел „Овластете ја интеграцијата“

Создајте клуч за конкретната продавница во CMS → Settings → API Keys. Поставете KORDIVA_STORE_ID, конфигурираниот KORDIVA_API_ORIGIN и соодветниот KORDIVA_TEST_API_KEY или KORDIVA_LIVE_API_KEY во заштитена серверска конфигурација. Следете го брзиот почеток.

Јавната инсталација не дава API пристап. Постојната серверска автентикација ги проверува продавницата, TEST/LIVE средината, повлекувањето клучеви и подобноста на сметката. Користете @kordiva/sdk само во Node серверски рути; React и checkout помошниците добиваат само одобрени URL за наплата од вашиот сервер. Не користете NEXT_PUBLIC_ или VITE_ променливи за клучеви.

Проверка на јавно инсталирани пакети

Дел „Проверка на јавно инсталирани пакети“

Во чист проект надвор од Kordiva репозиториумот проверете ја инсталацијата на јавните пакети 0.1.3:

Терминал
pnpm add @kordiva/[email protected] @kordiva/[email protected] @kordiva/[email protected]
pnpm list @kordiva/sdk @kordiva/react @kordiva/checkout

React апликациите дополнително бараат React 18.2+ или 19; тој пакет го наведува React како peer dependency. Трите пакети имаат ESM и TypeScript декларации; користете import, не require. Не ставајте Store API клуч во клиентски код. Изборниот Node webhook проверувач не е за прелистувач или Edge.

Изворниот monorepo и понатаму има private: true како заштита од случајно објавување; тоа не значи дека јавните npm архиви се приватни.

Решавање проблеми

Дел „Решавање проблеми“
  • npm 404: проверете го точното име @kordiva/..., побараната верзија и јавниот npm регистар. Ново објавена верзија може привремено да не е достапна; не инсталирајте неофицијална замена.
  • 401/403 од Kordiva: проверете ги Store ID, средината на клучот, повлекувањето и потребната претплата или Individual одобрување. Повторна SDK инсталација не дава овластување.
  • Неуспешен browser import: преместете го @kordiva/sdk во заштитена серверска рута; во прелистувач користете @kordiva/react или @kordiva/checkout.

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

Дел „Поврзани водичи“

Автентикација · Брз почеток · React · Безбедност

Business subscriptions · Merchant webhooks · Verification