---
title: "Changes to Create a Checkout Session"
method: POST
path: "/v1/checkout_sessions"
---

# Changes to Create a Checkout Session

`POST /v1/checkout_sessions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `f9ffaecbfe3d`: 10 breaking, 9 warning, 16 info

## Changes

- **2026-11-03** `f9ffaecbfe3d`: 10 breaking, 9 warning, 16 info
  - the request property `data/attributes/line_items/items/amount` became required
  - the request property `data/attributes/line_items/items/name` became required
  - the request property `data/attributes/line_items/items/quantity` became required
  - the request property `data/attributes/split_payment/recipients/items/split_type` became required
  - removed the enum value `fixed` of the request property `data/attributes/split_payment/recipients/items/split_type`
  - removed the enum value `percentage_net` of the request property `data/attributes/split_payment/recipients/items/split_type`
  - the `data/attributes/billing` request property type changed from no type to `object`
  - the `data/attributes/line_items/items/amount` request property format changed from no format to `int32`
  - the `data/attributes/line_items/items/quantity` request property format changed from no format to `int32`
  - the `data/attributes/split_payment/recipients/items/value` request property format changed from no format to `int32`
  - removed `#/components/schemas/BillingDTO` from the `data/attributes/billing` request property `allOf` list
  - removed the request property `data/attributes/customer_email`
  - removed the request property `data/attributes/customer_id`
  - removed the request property `data/attributes/merchant`
  - removed the request property `data/attributes/origin`
  - removed the request property `data/attributes/pass_on_fees`
  - removed the optional property `data` from the response with the `200` status
  - removed the optional property `errors` from the response with the `400` status
  - removed the optional property `has_more` from the response with the `200` status
  - api operation id `create_checkout_sessions` removed and replaced with `create-a-checkout`
  - the endpoint scheme security `BasicAuth` was removed from the API
  - api tag `Checkout Sessions` removed
  - added the new optional `header` request parameter `Content-Type`
  - added the new optional request property `data/attributes/billing/address`
  - added the new optional request property `data/attributes/billing/email`
  - added the new optional request property `data/attributes/billing/name`
  - added the new optional request property `data/attributes/billing/phone`
  - request body became optional
  - the request property `data/attributes/line_items/items/currency` with a default value became required
  - the `currency` request property default value `PHP` was added
  - the `images` request property default value `` was added
  - the `send_email_receipt` request property default value `false` was added
  - the `show_description` request property default value `true` was added
  - the `show_line_items` request property default value `true` was added
  - removed the non-success response with the status `500`

---

[Operation](https://skmtc.dev/paymongo/apis/paymongo-api/docs/v1/checkout_sessions/post.md) - [API](https://skmtc.dev/paymongo/apis/paymongo-api.md) - [Page](https://skmtc.dev/paymongo/apis/paymongo-api/changes/v1/checkout_sessions/post)