---
title: "Create a hosted-checkout session (Paddle by default; configurable)"
method: POST
path: "/v1/checkout"
tags: ["billing"]
---

# Create a hosted-checkout session (Paddle by default; configurable)

`POST /v1/checkout`

## Request

- Base URL: `https://api.travelminds.ai`
- URL: `https://api.travelminds.ai/v1/checkout`
- Auth: none declared

Provider is chosen by BILLING_PROVIDER_MODE: 'paddle' (default, all customers cleared through Paddle as Merchant of Record), 'razorpay' (force Razorpay for all), or 'country' (route IN -> Razorpay, else -> Paddle). plan_id='enterprise' returns a mailto: contact-sales URL.

## Headers

- `authorization` string, nullable

## Request body

- CheckoutBody
  - `plan_id` string, required
  - `billing_cycle` string

## Response `200`

Successful Response

- CheckoutResponse
  - `provider` string, nullable
  - `url` string, nullable
  - `transaction_id` string, nullable
  - `subscription_id` string, nullable
  - `contact_sales` boolean, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/travelminds/apis/travelmindsai-api-gateway.md) · [All operations](https://skmtc.dev/travelminds/apis/travelmindsai-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/travelminds/apis/travelmindsai-api-gateway/revisions/d05c8634e340?raw)