Checkout

Create a checkout session

post

Creates a checkout session from a secure server using an API Key. If you have a Customer token, see the Storefront API Create Checkout endpoint.

Authorizations

APIKey

AuthorizationstringRequired

An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.

Path parameters

storeIdstringRequired

Body

application/jsontext/jsonapplication/*+json

Request to create a new checkout session from your back-end server using the management API. customer_id needs to be specified explicitly here instead of using a Customer token.

subscriptionnull | booleanOptionalDeprecated

Whether this checkout creates a subscription. DEPRECATED: Use 'subscription' field in 'lines' array objects instead.

coupon_idstring · flake-idOptionalExample: 411486491630370816

affiliate_codenull | stringOptional

Optional affiliate code to track referrals

return_urlnull | stringOptional

Optional URL to redirect to after successful checkout

cancel_urlnull | stringOptional

Optional URL to redirect to if checkout is canceled

auto_redirectnull | booleanOptional

Whether to automatically redirect the customer (return_url must be set)

metadatanull | objectOptional

Optional metadata to associate with the checkout session. Do not store any sensitive information here.

customer_idstring · flake-idRequiredExample: 411486491630370816

Responses

200

OK

application/json

default

Error response

application/json

post

/v1/stores/{storeId}/checkouts

HTTPcURLJavaScriptPython

POST /v1/stores/{storeId}/checkouts HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 2087

{
  "lines": [
    {
      "subscription": null,
      "trial": null,
      "gift_to": {
        "platform": "invalid",
        "id": "76561198152492642"
      },
      "gift_to_customer_id": "411486491630370816",
      "quantity": 1,
      "selected_gameserver_id": "411486491630370816",
      "metadata": null,
      "custom_variables": null,
      "product_id": "411486491630370816",
      "inline_product": {
        "slug": null,
        "name": null,
        "description": null,
        "label": null,
        "price": null,
        "single_game_server_only": null,
        "allow_one_time_purchase": null,
        "allow_subscription": null,
        "subscription_interval_value": null,
        "subscription_interval_scale": "invalid",
        "trial": {
          "enabled": null,
          "period_value": null,
          "period_scale": "invalid",
          "revoke_immediately_when_canceled": null,
          "new_customers_only": null,
          "new_customer_order_lookback_value": null,
          "new_customer_order_lookback_scale": "invalid",
          "allow_repeat_trials": null,
          "repeat_trial_cooldown_value": null,
          "repeat_trial_cooldown_scale": "invalid"
        },
        "remove_after_enabled": null,
        "remove_after_time_value": null,
        "remove_after_time_scale": "invalid",
        "store_stock_limit": {
          "enabled": true,
          "quantity": null,
          "time_value": null,
          "time_scale": "invalid",
          "include_trials": true
        },
        "customer_stock_limit": {
          "enabled": true,
          "quantity": null,
          "time_value": null,
          "time_scale": "invalid",
          "include_trials": true
        },
        "stock_limit_do_not_include_removed": null,
        "tags": [
          "411486491630370816"
        ],
        "gameservers": [
          "411486491630370816"
        ],
        "commands": [
          {
            "stage": "invalid",
            "content": "text",
            "online_only": true,
            "override_execute_on_gameserver_ids": [
              "411486491630370816"
            ]
          }
        ],
        "deliverable_actions": {
          "grant_giftcard": true
        },
        "metadata": null,
        "payout_splits": [
          {
            "user_id": "411486491630370816",
            "percentage": null,
            "platform_fee": 1
          }
        ],
        "tax_code": "unknown",
        "allow_concurrent_active_items": null,
        "is_hidden": null,
        "is_gifting_disabled": null,
        "enabled_at": null,
        "enabled_until": null,
        "required_product_ids": [
          "411486491630370816"
        ],
        "required_product_all": null,
        "custom_variable_ids": [
          "411486491630370816"
        ],
        "is_gift_cards_disabled": null,
        "is_coupons_disabled": null,
        "is_affiliate_links_disabled": null
      }
    }
  ],
  "coupon_id": "411486491630370816",
  "affiliate_code": null,
  "return_url": null,
  "cancel_url": null,
  "auto_redirect": null,
  "metadata": null,
  "customer_id": "411486491630370816"
}

application/jsontext/jsonapplication/*+json

{
  "id": "411486491630370816",
  "token": "text",
  "url": "text"
}