---
title: "POST /orders/"
method: POST
path: "/orders/"
tags: ["payments"]
---

# POST /orders/

`POST /orders/`

## Request body

- object
  - `business` string, required — Your Tonder API Key. You can retrieve it from the dashboard.
  - `client` string, required — The client authorization token: `auth_token`
  - `billing_address_id` string — The identifier for the billing address.
  - `shipping_address_id` string — The identifier for the shipping address.
  - `amount` integer, required — The total monetary value of the transaction.
  - `status` string, required — A code indicating the status of the transaction.
  - `reference` string, required — A unique identifier or reference number associated with the transaction.
  - `is_oneclick` boolean, required — A boolean value indicating whether the transaction involves a one-click purchase.
  - `items` object[], required — An array containing details about the items included in the transaction.
    - `description` string, required — A description for the item.
    - `quantity` integer, required — The quantity of the item added to the cart.
    - `price_unit` integer, required — The unit price of the item.
    - `discount` integer, required — The discount applied to the item.
    - `taxes` integer, required — The taxes associated with the item.
    - `product_reference` integer, required — A reference number or identifier for the product.
    - `name` string, required — The name or title of the product.
    - `amount_total` integer, required — The total monetary value of this specific cart item.

## Response `201`

Successful response

- object
  - `id` integer — An identifier associated with the order.
  - `created` string, date-time — The timestamp indicating the creation date and time of the order.
  - `amount` string — The total monetary value of the order.
  - `status` string — The status of the order.
  - `payment_method` string — The payment method used in the order.
  - `reference` string — A unique identifier or reference number associated with the order.
  - `is_oneclick` boolean — A boolean value indicating whether the order involves a one-click purchase.
  - `items` object[] — An array containing details about the items included in the order.
    - `description` string — A description of the item in the order.
    - `product_reference` string — A reference number or identifier for the product in the order.
    - `quantity` string — The quantity of the item in the order.
    - `price_unit` string — The unit price of the item in the order.
    - `discount` string — The discount applied to the item in the order.
    - `taxes` string — The taxes associated with the item in the order.
    - `amount_total` string — The total monetary value of the specific item in the order.
  - `billing_address` string — The billing address information in the order.
  - `shipping_address` string — The shipping address information in the order.
  - `client` object — Contains information about the client.
    - `email` string, email — The email address of the client.
    - `name` string — The full name of the client.
    - `first_name` string — The first name of the client.
    - `last_name` string — The last name of the client.
    - `client_profile` object
      - `gender` string — Gender information about the client.
      - `date_birth` string, date — Date of birth of the client.
      - `terms` boolean — A boolean indicating whether the client has agreed to terms.
      - `phone` string — Phone number of the client.

## Other responses

- `403` — Forbidden

---

[API](https://skmtc.net/tonderio/apis/tonder.md) · [All operations](https://skmtc.net/tonderio/apis/tonder/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tonderio/tonder/revisions/aface34fb9b2/schema)