Place an offline order

Completes the caller's active cart into one order with immutable line snapshots. Guests identify their cart with `X-Lynkow-Cart-Token` and must provide an email; signed-in buyers use their customer session and the account email. Contact, address, and an offline payment method are optional. All ids, statuses, order number, currency, totals, prices, and line snapshots are server-derived. Placement locks and rechecks the cart, creates the order and its items, and marks the cart completed in one transaction, so concurrent submits produce at most one order. A guest placement also creates or reuses the site's customer record for the order email in that same transaction, governed by a per-site kill-switch; the response shape is unchanged and no email is sent. Returns only the closed buyer confirmation whitelist. > **Note:** This endpoint requires the e-commerce feature to be enabled on your site.

POST/checkout
Base URLhttps://api.lynkow.com/storefront/{siteId}

Header parameters

X-Lynkow-Cart-Token
string

Guest cart secret returned when the cart was created. Omit for an authenticated customer checkout.

Request body

  • _hp
    string

    Spam-trap field that must remain empty when the site uses honeypot protection.

  • _ts
    integer

    Form-load Unix timestamp in milliseconds when the site uses honeypot protection.

  • email
    string

    Guest receipt email. Optional for an authenticated customer.

  • address
    object

    Optional delivery or collection address snapshot.

    • city
      string

      City or locality.

    • phone
      string

      Recipient phone number.

    • company
      string

      Recipient company name.

    • address1
      string

      Primary street address.

    • address2
      string

      Additional street address details.

    • lastName
      string

      Recipient family name.

    • province
      string

      Province, state, or region.

    • firstName
      string

      Recipient given name.

    • postalCode
      string

      Postal or ZIP code.

    • addressName
      string

      Buyer label for the address.

    • countryCode
      string

      ISO 3166-1 alpha-2 country code, normalized to uppercase.

  • contact
    object

    Optional buyer contact snapshot for this order.

    • name
      string

      Buyer contact name.

    • phone
      string

      Buyer contact phone number.

  • paymentMethod
    enum

    Offline payment method selected by the buyer. One of: on_site, cash_on_delivery, click_and_collect.

    One of: on_sitecash_on_deliveryclick_and_collect

  • recaptchaToken
    string

    Verification token when the site uses reCAPTCHA spam protection. For v3 checkout, mint it with the `checkout` action.

Feedback

Was this page helpful?