POST
/
v1
/
checkouts
curl --request POST \
  --url https://api.creem.io/v1/checkouts \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "request_id": "<string>",
  "product_id": "<string>",
  "units": 123,
  "discount_code": "<string>",
  "customer": {
    "id": "<string>",
    "email": "user@example.com"
  },
  "custom_field": [
    {
      "type": "text",
      "key": "<string>",
      "label": "<string>",
      "optional": true,
      "text": {
        "max_length": 123,
        "min_length": 123
      }
    }
  ],
  "success_url": "<string>",
  "metadata": [
    {}
  ]
}'
{
  "id": "<string>",
  "mode": "test",
  "object": "<string>",
  "status": "<string>",
  "request_id": "<string>",
  "product": {},
  "units": 123,
  "order": {
    "id": "<string>",
    "mode": "test",
    "object": "<string>",
    "customer": {},
    "product": {},
    "amount": 2000,
    "currency": "EUR",
    "fx_amount": 15,
    "fx_currency": "EUR",
    "fx_rate": 1.2,
    "status": "pending",
    "type": "subscription",
    "affiliate": "<string>",
    "created_at": "2023-09-13T00:00:00Z",
    "updated_at": "2023-09-13T00:00:00Z"
  },
  "subscription": {},
  "customer": {},
  "custom_fields": [
    {
      "type": "<string>",
      "key": "<string>",
      "label": "<string>",
      "optional": true,
      "text": {
        "max_length": 123,
        "min_length": 123
      }
    }
  ],
  "checkout_url": "<string>",
  "success_url": "https://example.com/return",
  "feature": [
    {
      "license": {
        "id": "<string>",
        "mode": "test",
        "object": "<string>",
        "status": "active",
        "key": "ABC123-XYZ456-XYZ456-XYZ456",
        "activation": 5,
        "activation_limit": 1,
        "expires_at": "2023-09-13T00:00:00Z",
        "created_at": "2023-09-13T00:00:00Z",
        "instance": [
          {
            "id": "<string>",
            "mode": "test",
            "object": "license-instance",
            "name": "My Customer License Instance",
            "status": "active",
            "created_at": "2023-09-13T00:00:00Z"
          }
        ]
      }
    }
  ],
  "metadata": [
    {}
  ]
}

Headers

​
x-api-key
string
required

Body

application/json
​
product_id
string
required

The ID of the product associated with the checkout session.

​
request_id
string

Identify and track each checkout request.

​
units
number

The number of units for the order.

​
discount_code
string

Prefill the checkout session with a discount code.

​
customer
object

Customer data for checkout session. This will prefill the customer info on the checkout page

​
custom_field
object[]

Collect additional information from your customer using custom fields. Up to 3 fields are supported.

​
success_url
string

The URL to which the user will be redirected after the checkout process is completed.

​
metadata
object[]

A key-value pair where the key is a string, and the value can be a string, number, or null. This metadata will be propagated across all related objects, such as subscriptions and customers.

Response

200 - application/json
Successfully created a checkout session
​
id
string
required

Unique identifier for the object.

​
mode
enum<string>
required

String representing the environment.

Available options:
test,
live,
sandbox
​
object
string
required

String representing the object’s type. Objects of the same type share the same value.

​
status
string
required

Status of the checkout.

​
product
object
required

The product associated with the checkout session.

​
checkout_url
string
required

The URL to which the customer will be redirected to complete the payment.

​
success_url
string
required

The URL to which the user will be redirected after the checkout process is completed.

Example:

"https://example.com/return"

​
request_id
string

Identify and track each checkout request.

​
units
number

The number of units for the of the product.

​
order
object

The order associated with the checkout session.

​
subscription
object

The subscription associated with the checkout session.

​
customer
object

The customer associated with the checkout session.

​
custom_fields
object[]

Additional information collected from your customer during the checkout process.

​
feature
object[]

Features issued for the order.

​
metadata
object[]

A key-value pair where the key is a string, and the value can be a string, number, or null.