---
title: "Checkout Session Create"
method: POST
path: "/checkout-sessions"
tags: ["Front-end Order Creation"]
---

# Checkout Session Create

`POST /checkout-sessions`

## Request

- Base URL: `https://paella-sandbox.billie.io/api/v2`
- URL: `https://paella-sandbox.billie.io/api/v2/checkout-sessions`
- Auth: OAuth 2
  - Password
  - Token URL: `/oauth/token`
- TypeScript: <https://skmtc.dev/billie/apis/billie-direct-api/docs/checkout-sessions/post.ts> (a function with typed inputs; its response is checked against the schema)

**Purpose:**

Creates a session ID that is used to initiate the widget for a dedicated checkout session with a customer. 

**Preconditions:**

- n/a

**Success:**

- Response Code: HTTP 200
- response body: `id` → session ID for the checkout session

**Attention:**

- The session has an expiry time of 48 hours.

## Request body

- object
  - `merchant_customer_id` string

## Response `200`

Checkout session created.

- object
  - `id` string, uuid, required

## Other responses

- `400`: Invalid Request Data
- `401`: Unauthorized request or invalid credentials
- `500`: Unexpected Server Error

## Changes

- **2026-11-03** `29d6a8a63ff9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/billie/apis/billie-direct-api/changes/checkout-sessions/post.md)

---

[API](https://skmtc.dev/billie/apis/billie-direct-api.md) - [All operations](https://skmtc.dev/billie/apis/billie-direct-api/llms.txt) - [OpenAPI document](https://skmtc.dev/billie/apis/billie-direct-api/revisions/29d6a8a63ff9?raw)