---
title: "Create order"
method: POST
path: "/api/public/v1/orders"
tags: ["Orders"]
---

# Create order

`POST /api/public/v1/orders`

## Request

- Base URL: `http://localhost:3009`
- URL: `http://localhost:3009/api/public/v1/orders`
- Auth: HTTP basic

Creates a regular (PP3) order via the Public API

## Headers

- `Authorization` string, required

## Request body

- object
  - `merchant` object, required
    - `id` string, required
    - `store_ref` string, required
  - `operator_ref` string, required
  - `reference` string
  - `cart_items` object[], required
    - `reference` string
    - `name` string
    - `quantity` integer
    - `price_with_tax` integer
    - `type` string
  - `given_names` string
  - `surnames` string: Customer's combined surnames. Use first_surname + second_surname instead for Mexican merchants.
  - `first_surname` string: Customer's first surname. Used for Mexican merchants instead of surnames.
  - `second_surname` string: Customer's second surname. Used for Mexican merchants instead of surnames.
  - `date_of_birth` string
  - `nin` string
  - `address` string
  - `postal_code` string
  - `city` string
  - `colony` string: Customer's neighborhood/colony. Used for Mexican merchants.
  - `joint_customer` string: Name of a second account holder or beneficiary associated with this subscription.

## Response `201`

successful

## Other responses

- `401`: unauthorized
- `422`: unprocessable entity

---

[API](https://skmtc.dev/sequra/apis/instore-api.md) - [All operations](https://skmtc.dev/sequra/apis/instore-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sequra/apis/instore-api/revisions/29430b803abc?raw)