Kordiva

Developer Guide

API Integration for Custom Stores

Build your own storefront UI and use Kordiva APIs for catalog, checkout initiation, and payment confirmation.

API Key Access

Per-store key authentication for scoped and revocable access.

Checkout Session

Create short-lived checkout URLs from external cart line items.

Payment Confirmation

Server-side confirmation endpoint for reliable paid status checks.

Integration Steps

  1. 1Generate Store API key in CMS (Settings -> API Keys).
  2. 2Fetch products from Public Catalog endpoints.
  3. 3Create checkout session with orderRef and idempotencyKey.
  4. 4Redirect customer to checkoutUrl.
  5. 5Confirm status via payment-confirmations endpoint.

Core Endpoints

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

Full request/response examples are available in your store admin at Settings -> API guide.

Security Rules

  • Never expose API keys in client-side JavaScript.
  • Call the API from your backend and forward only required data.
  • Use idempotency keys for every checkout create request.
  • Treat success URL as UX only; use payment-confirmations as source of truth.

Need implementation help?

Our team can help you connect your custom frontend and backend with Kordiva APIs in a production-safe way.

Contact SalesView Pricing