---
title: "Changes to Create a checkout session"
method: POST
path: "/v1/sdk/checkout-sessions"
---

# Changes to Create a checkout session

`POST /v1/sdk/checkout-sessions`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 27 revisions.

- **2026-07-17** `bbc2ff2bc849` — 3 warning
- **2026-07-04** `a30b6aef464d` — 2 info
- **2026-04-04** `88abf6f50f11` — 2 breaking, 4 info
- **2026-02-27** `9079f361f51c` — 1 info

## Changes

- **2026-07-17** `bbc2ff2bc849` — 3 warning
  - the `customerRef` request property's maxLength was set to `20`
  - the `planRef` request property's maxLength was set to `20`
  - the `productRef` request property's maxLength was set to `20`
- **2026-07-04** `a30b6aef464d` — 2 info
  - the endpoint scheme security `SecretKey` was added to the API
  - the endpoint scheme security `bearer` was removed from the API
- **2026-04-04** `88abf6f50f11` — 2 breaking, 4 info
  - the `customerRef` request property's minLength was increased from `0` to `1`
  - the `productRef` request property's minLength was increased from `0` to `1`
  - added the new optional request property `purpose`
  - the request property `productRef` became optional
  - the response property `checkoutUrl` became required for the status `201`
  - the response property `sessionId` became required for the status `201`
- **2026-02-27** `9079f361f51c` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/solvapay/apis/solvapay-rest-api/docs/v1/sdk/checkout-sessions/post.md) · [API](https://skmtc.dev/solvapay/apis/solvapay-rest-api.md) · [Page](https://skmtc.dev/solvapay/apis/solvapay-rest-api/changes/v1/sdk/checkout-sessions/post)