Checkout API: TEST и LIVE

API клучот ја определува средината. TEST и LIVE checkout интерфејсите намерно се различни во тековната имплементација.

LIVE checkout-session интерфејс

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

Користете овластен LIVE клуч само по одделно активирање. Испратете lineItems со ID на производ, опционална варијанта и количина; опционално checkoutType (native или stripe_hosted), checkoutLanguage (mk или en), orderRef, customerRef, return/success URL и истекување.

Користете стабилен Idempotency-Key за еден логички обид. Header и body мора да се совпаѓаат ако се дадени двете вредности. Зачувајте ја вратената session референца. Individual останува еднократно дигитално и ограничено по купувачки пазар.

За Individual LIVE продажби задолжителни се хостираната наплата и проверките за локација и данок. Општата native опција во заедничкиот Business договор не овозможува директна Individual картична форма.

TEST checkout интерфејс

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

Користете TEST клуч и тело со productId. Individual бара и testSaleMarket (US, CA или AU). Ова се TEST контексти, не потврдени LIVE дозволи. Одговорот враќа data.environment: TEST и checkout URL; токенот е приватен.

TEST клучеви поддржуваат каталог читања и оваа конкретна TEST checkout патека. Општиот checkout-session POST и payment-confirmation GET не се поддржани со TEST клуч во тековниот handler. Не ветувајте идентично API покривање и не менувајте headers за заобиколување.

Редослед на интеграција

1. Читајте каталог серверски со соодветен клуч.
2. Изберете checkout интерфејс според средината.
3. Пренасочете кон вратениот checkout URL.
4. За LIVE потврдете серверски пред испорака. За изолиран TEST користете поддржан резултат и TEST статус; не заклучувајте LIVE подготвеност.

Поврзани водичи

Автентикација · Потврда на плаќање · Вистински TEST интерфејс