---
title: "Create instore order"
method: POST
path: "/v1/instore/orders"
tags: ["Instore"]
---

# Create instore order

`POST /v1/instore/orders`

Create an instore order and charge the customer. Use the correct Bearer token for authentication.

## Request body

- object
  - `totalAmount` Amount, required — The monetary amount.
    - `amount` string, required — Monetary value. Example: 187.95.
    - `currency` string, required — Currency code.
  - `preApprovalCode` string, required — Barcode presented by the customer. It is the code shown to the cashier for payment.
  - `requestId` string, required — Unique identifier for the v2/instore/orders request from the POS system. It is available in your merchant dashboard.
  - `merchantOperatorId` string, required — String identifier of the POS operator, such as an employee ID or name.
  - `items` object[], required — List of items in the order.
    - `gtin` string — Global Trade Item Number (UPC, EAN, JAN, ISBN, ITF-14).
    - `quantity` integer, required — Quantity of the item.
    - `price` Amount, required — The monetary amount.
      - `amount` string, required — Monetary value. Example: 187.95.
      - `currency` string, required — Currency code.
    - `name` string, required — Name of the item.
    - `category` string, required — Category of the item.
    - `subcategory` string[] — Subcategories of the item.
    - `sku` string, required — Stock Keeping Unit (SKU) code.
    - `brand` string — Brand name.
    - `pageUrl` string — URL of the product page.
    - `imageUrl` string — URL of the product image.
  - `merchantReference` string, required — Merchant reference for tracking the order in your system.

## Response `200`

Instore order created successfully.

## Other responses

- `400` — Bad request
- `401` — Unauthorized

---

[API](https://skmtc.dev/scalapay/apis/scalapay-api.md) · [All operations](https://skmtc.dev/scalapay/apis/scalapay-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scalapay/scalapay-api/revisions/c43238b80cb9/schema)