Водич за програмери

Поврзете го вашиот систем.Поедноставете ја продажбата.

Поврзете производи, наплата и потврда на плаќање со вашата продавница или апликација преку Kordiva API.

checkout.http
HTTP / JSON
POST /public/catalog/stores/:storeId/
     checkout-sessions

orderRef: "your-order-reference"
idempotencyKey: "unique-request-key"

→ checkoutUrl

Преглед на текот, не целосно барање. Целосните податоци и примери за автентикација се во Поставки → API водич.

checkoutUrlИлустративен одговор

За програмери

Основата за вашата интеграција.

Задржете го сопствениот frontend и поврзете ги поддржаните продажни операции што им требаат на вашите купувачи.

Безбеден API пристап

Автентикација по продавница со ограничени клучеви што може да се отповикаат. Чувајте ги на вашиот сервер.

Сесии за наплата

Креирајте краткотрајни URL адреси од надворешната кошничка и пренасочете ги купувачите кон наплата.

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

Проверете го платежниот статус од вашиот backend пред да означите нарачка како платена.

Од клуч до наплата

Чекори за интеграција

  1. 01

    Генерирајте Store API клуч во CMS (Поставки -> API клучеви).

  2. 02

    Преземете производи од Public Catalog endpoint-и.

  3. 03

    Креирајте checkout session со orderRef и idempotencyKey.

  4. 04

    Пренасочете го купувачот кон checkoutUrl.

  5. 05

    Потврдете статус преку payment-confirmations endpoint.

Јавен каталог и наплата

Клучни endpoint-и

GET /public/catalog/stores/:storeId/products
POST /public/catalog/stores/:storeId/checkout-sessions
GET /public/catalog/stores/:storeId/payment-confirmations

Целосни примери за барања и одговори се достапни во администрацијата на продавницата: Поставки → API водич.

Безбедноста е прва

Чувајте ги клучевите на сервер. Потврдете го секое плаќање.

  • Никогаш не изложувајте API клучеви во client-side JavaScript.
  • Повикајте API преку вашиот backend и проследете само потребни податоци.
  • Користете idempotency key за секое барање за checkout create.
  • Третирајте success URL како UX; payment-confirmations е source of truth.

Подготвени за изработка

Ваша продавница, ваш систем.Kordiva како основа.

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