Create an HTML Mode public order

post

https://api.scalev.com/v3/pages/{page_unique_id}/orders

Page-scoped public endpoint for HTML Mode Scalev.checkout.createOrder. This route accepts HTML Mode order payloads with customer, destination, items, and shipping_option, requires X-Scalev-Page-Api-Key, and does not accept storefront public API keys. The page and store are resolved from the path and page API key; any page_unique_id or store_unique_id values supplied in the JSON body are ignored.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

page_unique_id

string

required

Public page unique ID.

Body Params

HTML Mode public order payload. Use customer, destination, and one combined items list for checkout details. Pass the chosen option returned by shippingOptions as shipping_option. The API ignores any supplied page_unique_id or store_unique_id and uses the path page plus the authenticated page API key instead.

form

object | null

customer

object

Buyer contact details submitted by an HTML Mode page.

destination

object

Buyer destination submitted by an HTML Mode page.

items

array of objects

length ≥ 1

items

payment_method

string

Public order payment method code. Required for normal checkout. May be omitted when the store uses strict two-step Payment Link checkout; Nexus resolves it to payment_link. Virtual Accounts use flat method codes such as va_bca.

payment_account_unique_id

string | null

shipping_option

object

product_discount

shipping_discount

discount_code_code

string | null

notes

string | null

transferproof_url

string | null

cart_id

recaptcha_token

string | null

Runtime-generated form reCAPTCHA token.

event_source_url

uri | null

fbc

string | null

fbp

string | null

ttclid

string | null

gclid

string | null

ttp

string | null

kwai_clickid

string | null

utm_source

string | null

utm_medium

string | null

utm_campaign

string | null

utm_content

string | null

utm_term

string | null

affiliate_code

string | null

channel_unique_id

string | null

metadata

object | null

Headers

X-Scalev-Page-Api-Key

string

required

Publishable page public API key for the page_unique_id path page. Storefront public API keys are not accepted on page-scoped public routes.

Responses

201Flat HTML Mode public order object.

400Bad Request

404Not Found