---
title: "Create a new order and get checkout URL"
method: POST
path: "/v1/billing/orders"
tags: ["Billing"]
---

# Create a new order and get checkout URL

`POST /v1/billing/orders`

## Request body

- CreateOrderDto
  - `items` object[], required — Order items
    - `productId` string, uuid, required — Product ID
    - `quantity` integer, required — Quantity of the product
  - `successUrl` string, uri, required — URL to redirect to after successful payment
  - `cancelUrl` string, uri, required — URL to redirect to if payment is cancelled

## Response `201`

Order created successfully

- CreateOrderApiResponseDto
  - `success` boolean, required — Indicates if the request was successful
  - `message` string, required — Human readable message
  - `data` object, required — Response data
    - `orderId` string, uuid, required — Created order ID
    - `checkoutUrl` string, uri, required — Stripe checkout URL
  - `timestamp` string, date-time, required — Timestamp of the response

---

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