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

# Create order

`POST /api/public/v1/orders`

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/checkout-api.md) · [All operations](https://skmtc.dev/sequra/apis/checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequra/checkout-api/revisions/2b0b60c52d04/schema)