Checkout

Create a checkout session

post

Creates a checkout session using a Customer token. After creating the checkout session, redirect the customer to the url returned.

Authorizations

Customer

AuthorizationstringRequired

A Customer token generated using an API Key in the format 'Customer TOKEN_HERE'.

Header parameters

x-paynow-customer-ipstring · ipv4Optional

The IP address (IPv4 or IPv6) of the customer. Required if the request is not being made from the customer's browser.

x-paynow-customer-countrycodestringOptional

The customer's country code in ISO 3166-1 alpha-2 format. Optional, but recommended if you have this available.

Pattern: ^[A-Z]{2}$

Body

application/jsontext/jsonapplication/*+json

Request to create a new checkout session

subscriptionboolean · nullableOptionalDeprecated

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

coupon_idstring · flake-idOptionalExample: 411486491630370816

affiliate_codestring · nullableOptional

Optional affiliate code to track referrals

return_urlstring · nullableOptional

Optional URL to redirect to after successful checkout

cancel_urlstring · nullableOptional

Optional URL to redirect to if checkout is canceled

auto_redirectboolean · nullableOptional

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

Responses

200

OK

application/json

Response after creating a checkout session

idstring · flake-idRequiredExample: 411486491630370816

tokenstringRequired

The token for the checkout session

urlstringRequired

The URL to redirect the customer to complete checkout

default

Error response

application/json

post

/v1/checkouts

HTTPcURLJavaScriptPython

POST /v1/checkouts HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 376

{
  "lines": [
    {
      "product_id": "411486491630370816",
      "subscription": null,
      "trial": null,
      "gift_to": {
        "platform": "invalid",
        "id": "76561198152492642"
      },
      "gift_to_customer_id": "411486491630370816",
      "quantity": 1,
      "selected_gameserver_id": "411486491630370816",
      "custom_variables": null
    }
  ],
  "coupon_id": "411486491630370816",
  "affiliate_code": null,
  "return_url": null,
  "cancel_url": null,
  "auto_redirect": null
}

application/jsontext/jsonapplication/*+json

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