Create a public checkout order

post

https://api.scalev.com/v3/stores/{store_id}/public/checkout

Public storefront endpoint. Create an order from direct items, from the guest cart referenced by X-Scalev-Guest-Token, or from direct items while clearing the referenced guest cart after successful order creation. Direct checkout items are store-scoped and not blocked by storefront listing visibility.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

store_id

string

required

Store unique_id.

Body Params

items

array of objects

length between 1 and 50

Optional direct item source. If supplied, direct items create the order. If X-Scalev-Guest-Token references a guest cart, that cart is cleared after successful order creation. If omitted, the guest cart referenced by X-Scalev-Guest-Token creates the order.

items

customer_name

string

required

length ≤ 200

customer_email

string

required

length ≤ 254

customer_phone

string | null

shipping_address

string | null

shipping_province

string | null

shipping_city

string | null

shipping_subdistrict

string | null

shipping_postal_code

string | null

shipping_location_id

address

string | null

deprecated

location

string | null

deprecated

location_id

postal_code

string | null

deprecated

payment_method

string

Storefront payment method code selected by the buyer. 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.

courier_service_id

integer | null

warehouse_unique_id

string | null

courier_aggregator_code

string | null

discount_code_code

string | null

notes

string | null

Headers

X-Scalev-Storefront-Api-Key

string

required

Publishable storefront public API key for the target store. Page public API keys are not accepted on Storefront public routes.

X-Scalev-Guest-Token

uuid

Browser-safe guest cart token returned by the first guest-cart response when no token is sent. Send it on later guest-cart and public checkout calls to keep the same cart after reloads.

Responses

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Public checkout order

400Bad Request

404Not Found