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

default

Error response

application/json

post

/v1/checkouts

HTTPcURLJavaScriptPython

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

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

application/jsontext/jsonapplication/*+json

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