v2

OpenAPI 3.0.3Proprietary2026-07-263483431.1 MB

Storefront

Create a public checkout order

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.

post/v3/stores/{store_id}/public/checkout

Request body

customer_namestring required

customer_emailstring email required

customer_phonestring nullable

shipping_addressstring nullable

shipping_provincestring nullable

shipping_citystring nullable

shipping_subdistrictstring nullable

shipping_postal_codestring nullable

addressstring nullable

locationstring nullable

postal_codestring nullable

payment_methodstring

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; Scalev resolves it to payment_link. Virtual Accounts use flat method codes such as va_bca.

courier_service_idinteger nullable

warehouse_unique_idstring nullable

courier_aggregator_codestring nullable

discount_code_codestring nullable

notesstring nullable

Example request

{
  "payment_method": "va_bca"
}

Response

Public checkout order

idstring uuid required

Canonical UUIDv7 order primary key returned by the partitioned orders table.

secret_slugstring required

public_order_urlstring uri nullable required

payment_urlstring uri nullable required

order_idstring required

statusstring required

payment_statusstring nullable required

Buyer-facing payment status. A settled payment is exposed as paid; this field never returns settled.

post_payment_redirect_urlstring uri

Canonical post-payment destination exposed only after a buyer-paid outcome (internal payment status paid or settled) when a valid redirect snapshot exists. Omitted before payment and when Scalev's hosted success flow applies.

is_probably_spamboolean nullable

draft_timestring date-time nullable

paid_timestring date-time nullable

transfer_timestring date-time nullable

transferproof_urlstring nullable

handler_phonestring nullable

chat_messagestring nullable

customer_idinteger nullable

discount_code_codestring nullable

other_income_namestring nullable

pg_payment_infoobject required

Buyer-facing payment gateway payload. Manual methods such as bank_transfer and cod can return an empty object. Virtual account methods expose provider reference and account details under the provider's payment_method object. QRIS responses expose QR data or a QR image payload. E-wallet, card, and invoice methods may expose provider actions or hosted provider URLs. SingaPay payments use normalized keys such as payment_url, deeplink_url, qr_string, qr_image_url, va_number, and va_name.

status_historyobject[]

payment_methodstring required

epayment_providerstring nullable

E-payment provider. xendit is the current/managed Xendit provider; xendit_legacy is the owned legacy Xendit provider. Other possible values include duitku, midtrans, durianpay, and singapay.

payment_account_holderstring nullable

payment_account_numberstring nullable

shipment_receiptstring nullable

variantsobject

bundle_price_optionsobject

payment_expiration_atstring date-time nullable

Example response

{
  "payment_method": "bank_transfer"
}