Glossary
Order — a snapshot of the cart with contact, delivery and totals; while draft it is the cart, after payment it never changes. Canonical JSON in the Order document.
Cart — what the shopper assembles in the shop. Neocarts has no separate entity: the cart is an order in status draft, which the shop server may replace wholesale with PUT /v1/shop/orders/{order}/items.
Draft — the first order status: items can still change, checkout has not started.
Item (line) — one product in an order with price, quantity and mode one_time or subscription.
Subscription — regular delivery of one product at a set interval; created only after the first payment succeeds, holding its own price, quantity and discount percentage.
Payment — one payment attempt; checking out again creates a new payment. Statuses in Statuses.
Card token — card details saved by the provider for charges without the shopper present; without it no subscription can be created (card_not_saved).
Charge — a recurring payment for a subscription; each one creates a new order for the period.
Repricing — changing a product’s price on active and paused subscriptions via PUT …/price; applies from the next charge.
Shop — a merchant in Neocarts; has a name, a country, an API key and a UUID.
Shop UUID (shop id) — the public shop identifier for the widget’s data-shop-id. Not secret. Shown in the shop panel on the «Integration» tab next to the API key.
API key (shop key) — the secret nc_live_… for the Shop API; shown once when generated, one live key per shop, rotating retires the old one immediately.
Webhook — a signed POST from Neocarts to the shop’s server about an event: order.paid, subscription.renewed, payment.refunded and others. The signature is HMAC-SHA256 with the whsec_… secret from the «Integration» tab. See Webhooks.
Order id — a UUID, the technical identifier the shop’s server hands to the widget in open({ orderId }).
Order number — the human-readable YYMMDD-NNNNN; safe to show to the shopper and in emails.
Shop server — the backend or platform plugin that calls the Shop API with the key; it alone names prices.
Shop API — the server-to-server API at https://core.neocarts.com/v1/shop/* with Authorization: Bearer nc_live_…; no CORS; versioned.
Widget API — the internal API the widget calls from the browser. Not a public contract: the shop does not call it, and it is not documented here.
Widget — the script https://cdn.neocarts.com/bundle.js: the subscribe button, the subscription modal, the “How it works” modal and the checkout dialog in Shadow DOM; computes no money.
Subscribe button — the <neocarts-button product-id="…" amount="…" title="…" image="…"> element under the buy button: shows the subscription price and opens a modal where the shopper picks the frequency; amount in kopecks. See Subscribe button.
Checkout — the widget steps: contact → delivery → review → payment → result.
Consent — the checkbox on the review step, required when subscription lines exist.
Shop panel — the merchant’s back office: orders, subscriptions, payments, customers, products, users, settings.
Shop config — what NeocartsSubscription.config() returns: name, discount, intervals, palette, readiness.
Readiness (config().ready) — payment is configured and at least one delivery method is enabled; otherwise the subscribe button renders nothing and open() rejects.
Kopecks — the unit of every amount: integers, 249000 = 2 490,00 ₴. See Money and rounding.
Subscription discount — a 0–100 percentage from the shop settings; copied onto the order and subscription at creation; subscription lines only.
Interval — delivery frequency: interval_value 1–365 and interval_unit day or week.
Preset — a ready-made interval the widget offers as a chip: 1, 2, 3, 4 weeks; the same for every shop.
Pause — a subscription state without charges; set manually (optionally with a date) or automatically (charge_failed, no_card).
Palette — one of 8 widget colour schemes chosen in the panel; individual colours are not configurable. List in Enums.
Locale — uk or en; Accept-Language drives the language of API responses, the order locale the language of shopper emails.
Payment provider — Plata by Mono or LiqPay (the shop’s keys are entered in the panel); after the first subscription it can be changed only through support.
Sandbox — the test provider on staging environments: no real money or card details, with buttons for success, decline and card-not-saved scenarios. Not on production yet.
Delivery directory — the carrier’s lists of cities, branches, parcel lockers and streets the shopper picks an address from in the widget; refreshed weekly.
Recipient — first name, last name and phone in the delivery block; may differ from the order contact.
redirect_url — where the widget sends the shopper via “Back to the shop” after a finished order; never given to the provider.
?neocarts=checkout marker — a URL parameter that makes the widget reopen the shopper’s last unfinished checkout on page load.