Водич за developers

API интеграција за custom продавници

Изградете сопствен storefront UI и користете Kordiva API за каталог, иницирање на checkout и потврда на плаќање.

API Key пристап

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

Checkout сесија

Креирајте краткотрајни checkout URL-а од line items од надворешна кошничка.

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

Server-side endpoint за сигурна проверка на платен статус.

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

  1. 1Генерирајте Store API клуч во CMS (Поставки -> API клучеви).
  2. 2Преземете производи од Public Catalog endpoint-и.
  3. 3Креирајте checkout session со orderRef и idempotencyKey.
  4. 4Пренасочете го купувачот кон checkoutUrl.
  5. 5Потврдете статус преку payment-confirmations endpoint.

Клучни endpoint-и

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

Целосни request/response примери се достапни во store admin на Поставки -> API водич.

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

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

Ви треба помош за имплементација?

Нашиот тим може да ви помогне да го поврзете вашиот custom frontend и backend со Kordiva API на production-safe начин.