API интеграција

Вистинска Business API форма, исечена пред примерите и метаподатоците за постојни клучеви. Име на клуч ја означува акредитивата; Креирај клуч би ја создал. Ниту еден клуч не е создаден, обновен или отповикан. LIVE ознаката не е Individual LIVE одобрение. Отворете целосна големина.

Модел и средина

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

API интеграцијата е за бизниси што веќе имаат WordPress, React, Next.js или друга веб-страница и не сакаат да го менуваат корисничкиот интерфејс. Kordiva останува системот за каталог и наплата во позадина.

Изборен SDK — истиот API, поедноставен код

Сакате TypeScript типови наместо рачни HTTP повици? Изборниот јавен Kordiva SDK 0.1.3 го користи постојниот поддржан API. Директниот HTTP API, CMS продавницата и Checkout Links продолжуваат непроменети.

• @kordiva/sdk — Node.js 20+ серверски клиент за каталог, TEST наплата, LIVE хостирана наплата и LIVE платежна потврда.
• @kordiva/checkout — безбедно пренасочување од прелистувач без клучеви.
• @kordiva/react — React/Next копче што го повикува вашиот backend, никогаш Kordiva со прелистувачки таен клуч.

pnpm add @kordiva/[email protected]
pnpm add @kordiva/[email protected] @kordiva/[email protected]

Видете SDK преглед, инсталација, React пример и HTML/WordPress пример. За WordPress или HTML со статичен Checkout Link не треба SDK ниту API клуч.

План

Business API пристапот за Kordiva E-commerce е вклучен во Basic, Professional и Enterprise со активна платена претплата.

Што добива твојата веб-страница

Преку API можеш да работиш со:

• производи и детали за производ;
• категории;
• атрибути;
• начини на достава;
• креирање сесија за наплата;
• сигурна серверска потврда на плаќањето.

API клуч

API клучот се креира во Поставки → API клучеви.

• потребен е ADMIN или повисок пристап;
• клучот е врзан за конкретна продавница;
• целосната вредност се прикажува при креирање;
• ако се изложи, укини го и креирај нов.

Не ставај таен API клуч во browser код

Клучот треба да се користи од серверски код или друг заштитен сервер. Не го вградувај во JavaScript што се испраќа до прелистувач.

Автентикација

Користи еден од поддржаните начини:

Authorization: Bearer <api-key>

или

x-api-key: <api-key>

Основната патека е /public/catalog.

Креирање сесија за наплата

POST /public/catalog/stores/:storeId/checkout-sessions

Во барањето можеш да испратиш производи, јазик, тип на наплата, референци на нарачка/купувач, адреси за враќање и рок на важност.

За секој логички обид за наплата користи стабилен Idempotency-Key.

Зачувај ги идентификаторите

Зачувај ги sessionId, orderRef и idempotencyKey. Ќе ти помогнат при потврда, retry и поддршка.

Потврда на плаќање

GET /public/catalog/stores/:storeId/payment-confirmations

Потврдата може да се побара со:

• sessionId;
• orderRef;
• idempotencyKey.

Успешна страница не е доказ

Не сметај дека плаќањето е успешно само затоа што купувачот се вратил на адресата за успешно плаќање. Конечниот статус провери го серверски преку Kordiva.

Stripe известувања

Kordiva ги обработува Stripe известувањата за Kordiva плаќањата. Твојата веб-страница не треба да поставува посебен Stripe webhook само за да ја потврди Kordiva наплатата.

Основен тек

1. Твојот backend го чита каталогот — Прикажи производи на сопствената веб-страница.
2. Креирај сесија за наплата — Испрати ги избраните производи и стабилен idempotency клуч.
3. Купувачот плаќа — Платежниот тек се извршува преку Kordiva/Stripe.
4. Потврди серверски — Провери го вистинскиот статус пред да означиш нарачка како платена во твој систем.

Business API 0.1.3

SDK 0.1.3 is publicly available on npm. Once backend activation is confirmed, use subscription reads and recurring checkout, Business Merchant events and raw-body HMAC verification. Standard flow is Stripe → Kordiva → merchant; no separate merchant Stripe webhook is needed. Customer identity is the server-bound opaque customerRef, not email or browser query parameters. Business refunds remain separate from Individual MoR requests; no SDK refund mutation is added.