Create a checkout session

Creates one payment journey on a checkout and returns the checkoutUrl to send the payer to. SHOPPING pays for a basket into the merchant’s settlement account; TOP_UP pays into an APPROVED payee. Returns 201 for a new session, or 200 with the original session when idempotencyKey was already used on this account. Returns 400 if the payee is not APPROVED or the currency does not match the checkout, and 404 if the checkout or payee is not on the account. Nothing is created when validation fails.

POST

roqqett

checkout-sessions

cURL

curl --request POST \
  --url 'https://api.equalsmoney.com/v2/roqqett/checkout-sessions?accountId={{accountId}}' \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "checkoutId": "6f1c2d0e-7a4b-4e2f-9c1d-3b5a7e9f0a12",
  "idempotencyKey": "3f9a1c2e-7b4d-4e8a-9c6f-0d2b5a8e1f47",
  "merchantReference": "ORDER-10421",
  "description": "Order ORDER-10421",
  "returnUrl": "https://shop.example.com/checkout/complete",
  "locale": "en-GB",
  "expiresAt": "2026-10-02T13:00:00Z"
}
'

import requests

url = "https://api.equalsmoney.com/v2/roqqett/checkout-sessions"

payload = {
    "type": "SHOPPING",
    "checkoutId": "6f1c2d0e-7a4b-4e2f-9c1d-3b5a7e9f0a12",
    "idempotencyKey": "3f9a1c2e-7b4d-4e8a-9c6f-0d2b5a8e1f47",
    "merchantReference": "ORDER-10421",
    "amount": {
        "amount": "10000.00",
        "currencyCode": "GBP"
    },
    "description": "Order ORDER-10421",
    "returnUrl": "https://shop.example.com/checkout/complete",
    "locale": "en-GB",
    "expiresAt": "2026-10-02T13:00:00Z",
    "basket": { "items": [
            {
                "name": "Linen shirt",
                "description": "Size M, blue",
                "quantity": 2,
                "unitPrice": {
                    "amount": "10000.00",
                    "currencyCode": "GBP"
                },
                "imageUrl": "https://shop.example.com/images/shirt.png"
            }
        ] },
    "shipping": {
        "amount": {
            "amount": "10000.00",
            "currencyCode": "GBP"
        },
        "address": {
            "streetName": "Upper Thames Street",
            "buildingNumber": "68",
            "buildingName": "Vintners Place",
            "postcode": "EC4V 3BJ",
            "city": "London",
            "region": "Greater London",
            "countryCode": "GB"
        }
    }
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    type: 'SHOPPING',
    checkoutId: '6f1c2d0e-7a4b-4e2f-9c1d-3b5a7e9f0a12',
    idempotencyKey: '3f9a1c2e-7b4d-4e8a-9c6f-0d2b5a8e1f47',
    merchantReference: 'ORDER-10421',
    amount: {amount: '10000.00', currencyCode: 'GBP'},
    description: 'Order ORDER-10421',
    returnUrl: 'https://shop.example.com/checkout/complete',
    locale: 'en-GB',
    expiresAt: '2026-10-02T13:00:00Z',
    basket: {
      items: [
        {
          name: 'Linen shirt',
          description: 'Size M, blue',
          quantity: 2,
          unitPrice: {amount: '10000.00', currencyCode: 'GBP'},
          imageUrl: 'https://shop.example.com/images/shirt.png'
        }
      ]
    },
    shipping: {
      amount: {amount: '10000.00', currencyCode: 'GBP'},
      address: {
        streetName: 'Upper Thames Street',
        buildingNumber: '68',
        buildingName: 'Vintners Place',
        postcode: 'EC4V 3BJ',
        city: 'London',
        region: 'Greater London',
        countryCode: 'GB'
      }
    }
  })
};

fetch('https://api.equalsmoney.com/v2/roqqett/checkout-sessions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.equalsmoney.com/v2/roqqett/checkout-sessions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'type' => 'SHOPPING',
    'checkoutId' => '6f1c2d0e-7a4b-4e2f-9c1d-3b5a7e9f0a12',
    'idempotencyKey' => '3f9a1c2e-7b4d-4e8a-9c6f-0d2b5a8e1f47',
    'merchantReference' => 'ORDER-10421',
    'amount' => [
        'amount' => '10000.00',
        'currencyCode' => 'GBP'
    ],
    'description' => 'Order ORDER-10421',
    'returnUrl' => 'https://shop.example.com/checkout/complete',
    'locale' => 'en-GB',
    'expiresAt' => '2026-10-02T13:00:00Z',
    'basket' => [
        'items' => [
                [
                                'name' => 'Linen shirt',
                                'description' => 'Size M, blue',
                                'quantity' => 2,
                                'unitPrice' => [
                                                                'amount' => '10000.00',
                                                                'currencyCode' => 'GBP'
                                ],
                                'imageUrl' => 'https://shop.example.com/images/shirt.png'
                ]
        ]
    ],
    'shipping' => [
        'amount' => [
                'amount' => '10000.00',
                'currencyCode' => 'GBP'
        ],
        'address' => [
                'streetName' => 'Upper Thames Street',
                'buildingNumber' => '68',
                'buildingName' => 'Vintners Place',
                'postcode' => 'EC4V 3BJ',
                'city' => 'London',
                'region' => 'Greater London',
                'countryCode' => 'GB'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.equalsmoney.com/v2/roqqett/checkout-sessions"

	payload := strings.NewReader("{\n  \"type\": \"SHOPPING\",\n  \"checkoutId\": \"6f1c2d0e-7a4b-4e2f-9c1d-3b5a7e9f0a12\",\n  \"idempotencyKey\": \"3f9a1c2e-7b4d-4e8a-9c6f-0d2b5a8e1f47\",\n  \"merchantReference\": \"ORDER-10421\",\n  \"amount\": {\n    \"amount\": \"10000.00\",\n    \"currencyCode\": \"GBP\"\n  },\n  \"description\": \"Order ORDER-10421\",\n  \"returnUrl\": \"https://shop.example.com/checkout/complete\",\n  \"locale\": \"en-GB\",\n  \"expiresAt\": \"2026-10-02T13:00:00Z\",\n  \"basket\": {\n    \"items\": [\n      {\n        \"name\": \"Linen shirt\",\n        \"description\": \"Size M, blue\",\n        \"quantity\": 2,\n        \"unitPrice\": {\n          \"amount\": \"10000.00\",\n          \"currencyCode\": \"GBP\"\n        },\n        \"imageUrl\": \"https://shop.example.com/images/shirt.png\"\n      }\n    ]\n  },\n  \"shipping\": {\n    \"amount\": {\n      \"amount\": \"10000.00\",\n      \"currencyCode\": \"GBP\"\n    },\n    \"address\": {\n      \"streetName\": \"Upper Thames Street\",\n      \"buildingNumber\": \"68\",\n      \"buildingName\": \"Vintners Place\",\n      \"postcode\": \"EC4V 3BJ\",\n      \"city\": \"London\",\n      \"region\": \"Greater London\",\n      \"countryCode\": \"GB\"\n    }\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.equalsmoney.com/v2/roqqett/checkout-sessions")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"type\": \"SHOPPING\",\n  \"checkoutId\": \"6f1c2d0e-7a4b-4e2f-9c1d-3b5a7e9f0a12\",\n  \"idempotencyKey\": \"3f9a1c2e-7b4d-4e8a-9c6f-0d2b5a8e1f47\",\n  \"merchantReference\": \"ORDER-10421\",\n  \"amount\": {\n    \"amount\": \"10000.00\",\n    \"currencyCode\": \"GBP\"\n  },\n  \"description\": \"Order ORDER-10421\",\n  \"returnUrl\": \"https://shop.example.com/checkout/complete\",\n  \"locale\": \"en-GB\",\n  \"expiresAt\": \"2026-10-02T13:00:00Z\",\n  \"basket\": {\n    \"items\": [\n      {\n        \"name\": \"Linen shirt\",\n        \"description\": \"Size M, blue\",\n        \"quantity\": 2,\n        \"unitPrice\": {\n          \"amount\": \"10000.00\",\n          \"currencyCode\": \"GBP\"\n        },\n        \"imageUrl\": \"https://shop.example.com/images/shirt.png\"\n      }\n    ]\n  },\n  \"shipping\": {\n    \"amount\": {\n      \"amount\": \"10000.00\",\n      \"currencyCode\": \"GBP\"\n    },\n    \"address\": {\n      \"streetName\": \"Upper Thames Street\",\n      \"buildingNumber\": \"68\",\n      \"buildingName\": \"Vintners Place\",\n      \"postcode\": \"EC4V 3BJ\",\n      \"city\": \"London\",\n      \"region\": \"Greater London\",\n      \"countryCode\": \"GB\"\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.equalsmoney.com/v2/roqqett/checkout-sessions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"type\": \"SHOPPING\",\n  \"checkoutId\": \"6f1c2d0e-7a4b-4e2f-9c1d-3b5a7e9f0a12\",\n  \"idempotencyKey\": \"3f9a1c2e-7b4d-4e8a-9c6f-0d2b5a8e1f47\",\n  \"merchantReference\": \"ORDER-10421\",\n  \"amount\": {\n    \"amount\": \"10000.00\",\n    \"currencyCode\": \"GBP\"\n  },\n  \"description\": \"Order ORDER-10421\",\n  \"returnUrl\": \"https://shop.example.com/checkout/complete\",\n  \"locale\": \"en-GB\",\n  \"expiresAt\": \"2026-10-02T13:00:00Z\",\n  \"basket\": {\n    \"items\": [\n      {\n        \"name\": \"Linen shirt\",\n        \"description\": \"Size M, blue\",\n        \"quantity\": 2,\n        \"unitPrice\": {\n          \"amount\": \"10000.00\",\n          \"currencyCode\": \"GBP\"\n        },\n        \"imageUrl\": \"https://shop.example.com/images/shirt.png\"\n      }\n    ]\n  },\n  \"shipping\": {\n    \"amount\": {\n      \"amount\": \"10000.00\",\n      \"currencyCode\": \"GBP\"\n    },\n    \"address\": {\n      \"streetName\": \"Upper Thames Street\",\n      \"buildingNumber\": \"68\",\n      \"buildingName\": \"Vintners Place\",\n      \"postcode\": \"EC4V 3BJ\",\n      \"city\": \"London\",\n      \"region\": \"Greater London\",\n      \"countryCode\": \"GB\"\n    }\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "id": "0b8e5c3a-2f1d-4c6b-8a9e-7d4f2c1b0a93",
  "type": "SHOPPING",
  "status": "OPEN",
  "checkoutId": "6f1c2d0e-7a4b-4e2f-9c1d-3b5a7e9f0a12",
  "merchantReference": "ORDER-10421",
  "description": "Order ORDER-10421",
  "amount": {
    "amount": "10000.00",
    "currencyCode": "GBP"
  },
  "payeeId": "d2a7c9e1-5b3f-4a8d-9e6c-1f0b2a4c8e57",
  "basket": {
    "items": [
      {
        "name": "Linen shirt",
        "description": "Size M, blue",
        "quantity": 2,
        "unitPrice": {
          "amount": "10000.00",
          "currencyCode": "GBP"
        },
        "imageUrl": "https://shop.example.com/images/shirt.png"
      }
    ]
  },
  "shipping": {
    "amount": {
      "amount": "10000.00",
      "currencyCode": "GBP"
    },
    "address": {
      "streetName": "Upper Thames Street",
      "buildingNumber": "68",
      "buildingName": "Vintners Place",
      "postcode": "EC4V 3BJ",
      "city": "London",
      "region": "Greater London",
      "countryCode": "GB"
    }
  },
  "locale": "en-GB",
  "checkoutUrl": "https://pay.roqqett.com/ch/pay/s/0b8e5c3a-2f1d-4c6b-8a9e-7d4f2c1b0a93",
  "returnUrl": "https://shop.example.com/checkout/complete",
  "paymentId": "9c4e1a7b-3d2f-4b6a-8e5c-0f7d2a9b1c34",
  "orderId": "7e2b9d4a-6c1f-4a5e-8b3d-2f9c0a1e6b78",
  "expiresAt": "2026-10-02T13:00:00Z",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z"
}

{
  "id": "0b8e5c3a-2f1d-4c6b-8a9e-7d4f2c1b0a93",
  "type": "SHOPPING",
  "status": "OPEN",
  "checkoutId": "6f1c2d0e-7a4b-4e2f-9c1d-3b5a7e9f0a12",
  "merchantReference": "ORDER-10421",
  "description": "Order ORDER-10421",
  "amount": {
    "amount": "10000.00",
    "currencyCode": "GBP"
  },
  "payeeId": "d2a7c9e1-5b3f-4a8d-9e6c-1f0b2a4c8e57",
  "basket": {
    "items": [
      {
        "name": "Linen shirt",
        "description": "Size M, blue",
        "quantity": 2,
        "unitPrice": {
          "amount": "10000.00",
          "currencyCode": "GBP"
        },
        "imageUrl": "https://shop.example.com/images/shirt.png"
      }
    ]
  },
  "shipping": {
    "amount": {
      "amount": "10000.00",
      "currencyCode": "GBP"
    },
    "address": {
      "streetName": "Upper Thames Street",
      "buildingNumber": "68",
      "buildingName": "Vintners Place",
      "postcode": "EC4V 3BJ",
      "city": "London",
      "region": "Greater London",
      "countryCode": "GB"
    }
  },
  "locale": "en-GB",
  "checkoutUrl": "https://pay.roqqett.com/ch/pay/s/0b8e5c3a-2f1d-4c6b-8a9e-7d4f2c1b0a93",
  "returnUrl": "https://shop.example.com/checkout/complete",
  "paymentId": "9c4e1a7b-3d2f-4b6a-8e5c-0f7d2a9b1c34",
  "orderId": "7e2b9d4a-6c1f-4a5e-8b3d-2f9c0a1e6b78",
  "expiresAt": "2026-10-02T13:00:00Z",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z"
}

{
  "message": "Checkout session not found.",
  "errors": [
    {
      "path": "string",
      "message": "string",
      "errorCode": "string"
    }
  ]
}

{
  "message": "Checkout session not found.",
  "errors": [
    {
      "path": "string",
      "message": "string",
      "errorCode": "string"
    }
  ]
}

{
  "message": "Checkout session not found.",
  "errors": [
    {
      "path": "string",
      "message": "string",
      "errorCode": "string"
    }
  ]
}

Authorizations

Authorization

string

header

required

Query Parameters

accountId

string

required

The ID of the account to work with.

Example:

"F50091"

Body

application/json

Body

Option 1
Option 2

type

enum<string>

required

Available options:

SHOPPING

checkoutId

string<uuid>

required

The checkout to take the session on. Its configured type must match type.

Maximum string length: 36

Example:

"6f1c2d0e-7a4b-4e2f-9c1d-3b5a7e9f0a12"

idempotencyKey

string

required

Caller-supplied key that makes creation safe to retry: a repeat with the same key on the same account returns the original checkout session instead of creating a second one. Use one key per payment journey.

Required string length: 1 - 255

Example:

"3f9a1c2e-7b4d-4e8a-9c6f-0d2b5a8e1f47"

merchantReference

string

required

The merchant's own reference for this checkout session, such as its order or basket ID. Shown to the merchant, never to the payer's bank.

Required string length: 1 - 128

Example:

"ORDER-10421"

amount

object

required

The total the payer pays, including any shipping. Must be in the checkout's currency.

Show child attributes

description

string

What the payment is for, as shown to the payer.

Required string length: 1 - 140

Example:

"Order ORDER-10421"

returnUrl

string<uri>

Where the payer is sent once the session ends. Defaults to the checkout's return URL.

Maximum string length: 2048

Example:

"https://shop.example.com/checkout/complete"

locale

string

BCP 47 language tag for the payer-facing checkout. Matches the locale set held against a person and account in CIS, so a value forwarded from Equals Money always validates. A locale Roqqett has no translations for yet renders in en-GB.

Pattern: ^[a-zA-Z]{2,3}(-[a-zA-Z]{4})?(-([a-zA-Z]{2}|\d{3}))?$

Example:

"en-GB"

expiresAt

string<date-time>

When the session expires if not paid. Must be in the future and within the checkout's maximum expiry window, which is also the default.

Example:

"2026-10-02T13:00:00Z"

basket

object

Show child attributes

shipping

object

Show child attributes

Response

string<uuid>

required

The ID of a checkout session: one payment journey.

Maximum string length: 36

Example:

"0b8e5c3a-2f1d-4c6b-8a9e-7d4f2c1b0a93"

type

enum<string>

required

SHOPPING pays for a basket into the merchant's settlement account. TOP_UP pays into a payee the merchant supplies.

Available options:

SHOPPING,

TOP_UP

Example:

"SHOPPING"

status

enum<string>

required

OPEN until the payer authorises at their bank, PROCESSING while the payment settles, then exactly one terminal status.

Available options:

OPEN,

PROCESSING,

COMPLETED,

CANCELLED,

ABANDONED,

EXPIRED

Example:

"OPEN"

checkoutId

string<uuid>

required

The ID of a checkout: the configured payment page a checkout session is taken on.

Maximum string length: 36

Example:

"6f1c2d0e-7a4b-4e2f-9c1d-3b5a7e9f0a12"

merchantReference

string

required

The merchant's own reference for this checkout session, such as its order or basket ID. Shown to the merchant, never to the payer's bank.

Required string length: 1 - 128

Example:

"ORDER-10421"

description

string | null

required

What the payment is for, as shown to the payer.

Maximum string length: 140

Example:

"Order ORDER-10421"

amount

object

required

The total the payer pays, including any shipping.

Show child attributes

payeeId

string<uuid> | null

required

The payee a TOP_UP session pays into. null for SHOPPING.

Maximum string length: 36

Example:

"d2a7c9e1-5b3f-4a8d-9e6c-1f0b2a4c8e57"

basket

object | null

required

Show child attributes

shipping

object | null

required

Show child attributes

locale

string | null

required

The locale the checkout is presented in. null when neither the request nor the checkout set one, in which case the payer's browser preference decides and en-GB is the final fallback.

Pattern: ^[a-zA-Z]{2,3}(-[a-zA-Z]{4})?(-([a-zA-Z]{2}|\d{3}))?$

Example:

"en-GB"

checkoutUrl

string<uri>

required

Where to send the payer to pay. Valid until expiresAt.

Maximum string length: 2048

Example:

"https://pay.roqqett.com/ch/pay/s/0b8e5c3a-2f1d-4c6b-8a9e-7d4f2c1b0a93"

returnUrl

string<uri> | null

required

Where the payer is sent once the session ends.

Maximum string length: 2048

Example:

"https://shop.example.com/checkout/complete"

paymentId

string<uuid> | null

required

The payment, once the payer has authorised one.

Maximum string length: 36

Example:

"9c4e1a7b-3d2f-4b6a-8e5c-0f7d2a9b1c34"

orderId

string<uuid> | null

required

The order a completed SHOPPING session produced. Always null for TOP_UP.

Maximum string length: 36

Example:

"7e2b9d4a-6c1f-4a5e-8b3d-2f9c0a1e6b78"

expiresAt

string<date-time>

required

When an OPEN session expires.

Example:

"2026-10-02T13:00:00Z"

createdAt

string<date-time>

required

The date the Resource was initially created. ISO 8601 format without milliseconds.

updatedAt

string<date-time>

required

The date the Resource was last modified. ISO 8601 format without milliseconds.

⌘I

cURL

curl --request POST \
  --url 'https://api.equalsmoney.com/v2/roqqett/checkout-sessions?accountId={{accountId}}' \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "checkoutId": "6f1c2d0e-7a4b-4e2f-9c1d-3b5a7e9f0a12",
  "idempotencyKey": "3f9a1c2e-7b4d-4e8a-9c6f-0d2b5a8e1f47",
  "merchantReference": "ORDER-10421",
  "description": "Order ORDER-10421",
  "returnUrl": "https://shop.example.com/checkout/complete",
  "locale": "en-GB",
  "expiresAt": "2026-10-02T13:00:00Z"
}
'

import requests

url = "https://api.equalsmoney.com/v2/roqqett/checkout-sessions"

payload = {
    "type": "SHOPPING",
    "checkoutId": "6f1c2d0e-7a4b-4e2f-9c1d-3b5a7e9f0a12",
    "idempotencyKey": "3f9a1c2e-7b4d-4e8a-9c6f-0d2b5a8e1f47",
    "merchantReference": "ORDER-10421",
    "amount": {
        "amount": "10000.00",
        "currencyCode": "GBP"
    },
    "description": "Order ORDER-10421",
    "returnUrl": "https://shop.example.com/checkout/complete",
    "locale": "en-GB",
    "expiresAt": "2026-10-02T13:00:00Z",
    "basket": { "items": [
            {
                "name": "Linen shirt",
                "description": "Size M, blue",
                "quantity": 2,
                "unitPrice": {
                    "amount": "10000.00",
                    "currencyCode": "GBP"
                },
                "imageUrl": "https://shop.example.com/images/shirt.png"
            }
        ] },
    "shipping": {
        "amount": {
            "amount": "10000.00",
            "currencyCode": "GBP"
        },
        "address": {
            "streetName": "Upper Thames Street",
            "buildingNumber": "68",
            "buildingName": "Vintners Place",
            "postcode": "EC4V 3BJ",
            "city": "London",
            "region": "Greater London",
            "countryCode": "GB"
        }
    }
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    type: 'SHOPPING',
    checkoutId: '6f1c2d0e-7a4b-4e2f-9c1d-3b5a7e9f0a12',
    idempotencyKey: '3f9a1c2e-7b4d-4e8a-9c6f-0d2b5a8e1f47',
    merchantReference: 'ORDER-10421',
    amount: {amount: '10000.00', currencyCode: 'GBP'},
    description: 'Order ORDER-10421',
    returnUrl: 'https://shop.example.com/checkout/complete',
    locale: 'en-GB',
    expiresAt: '2026-10-02T13:00:00Z',
    basket: {
      items: [
        {
          name: 'Linen shirt',
          description: 'Size M, blue',
          quantity: 2,
          unitPrice: {amount: '10000.00', currencyCode: 'GBP'},
          imageUrl: 'https://shop.example.com/images/shirt.png'
        }
      ]
    },
    shipping: {
      amount: {amount: '10000.00', currencyCode: 'GBP'},
      address: {
        streetName: 'Upper Thames Street',
        buildingNumber: '68',
        buildingName: 'Vintners Place',
        postcode: 'EC4V 3BJ',
        city: 'London',
        region: 'Greater London',
        countryCode: 'GB'
      }
    }
  })
};

fetch('https://api.equalsmoney.com/v2/roqqett/checkout-sessions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.equalsmoney.com/v2/roqqett/checkout-sessions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'type' => 'SHOPPING',
    'checkoutId' => '6f1c2d0e-7a4b-4e2f-9c1d-3b5a7e9f0a12',
    'idempotencyKey' => '3f9a1c2e-7b4d-4e8a-9c6f-0d2b5a8e1f47',
    'merchantReference' => 'ORDER-10421',
    'amount' => [
        'amount' => '10000.00',
        'currencyCode' => 'GBP'
    ],
    'description' => 'Order ORDER-10421',
    'returnUrl' => 'https://shop.example.com/checkout/complete',
    'locale' => 'en-GB',
    'expiresAt' => '2026-10-02T13:00:00Z',
    'basket' => [
        'items' => [
                [
                                'name' => 'Linen shirt',
                                'description' => 'Size M, blue',
                                'quantity' => 2,
                                'unitPrice' => [
                                                                'amount' => '10000.00',
                                                                'currencyCode' => 'GBP'
                                ],
                                'imageUrl' => 'https://shop.example.com/images/shirt.png'
                ]
        ]
    ],
    'shipping' => [
        'amount' => [
                'amount' => '10000.00',
                'currencyCode' => 'GBP'
        ],
        'address' => [
                'streetName' => 'Upper Thames Street',
                'buildingNumber' => '68',
                'buildingName' => 'Vintners Place',
                'postcode' => 'EC4V 3BJ',
                'city' => 'London',
                'region' => 'Greater London',
                'countryCode' => 'GB'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.equalsmoney.com/v2/roqqett/checkout-sessions"

	payload := strings.NewReader("{\n  \"type\": \"SHOPPING\",\n  \"checkoutId\": \"6f1c2d0e-7a4b-4e2f-9c1d-3b5a7e9f0a12\",\n  \"idempotencyKey\": \"3f9a1c2e-7b4d-4e8a-9c6f-0d2b5a8e1f47\",\n  \"merchantReference\": \"ORDER-10421\",\n  \"amount\": {\n    \"amount\": \"10000.00\",\n    \"currencyCode\": \"GBP\"\n  },\n  \"description\": \"Order ORDER-10421\",\n  \"returnUrl\": \"https://shop.example.com/checkout/complete\",\n  \"locale\": \"en-GB\",\n  \"expiresAt\": \"2026-10-02T13:00:00Z\",\n  \"basket\": {\n    \"items\": [\n      {\n        \"name\": \"Linen shirt\",\n        \"description\": \"Size M, blue\",\n        \"quantity\": 2,\n        \"unitPrice\": {\n          \"amount\": \"10000.00\",\n          \"currencyCode\": \"GBP\"\n        },\n        \"imageUrl\": \"https://shop.example.com/images/shirt.png\"\n      }\n    ]\n  },\n  \"shipping\": {\n    \"amount\": {\n      \"amount\": \"10000.00\",\n      \"currencyCode\": \"GBP\"\n    },\n    \"address\": {\n      \"streetName\": \"Upper Thames Street\",\n      \"buildingNumber\": \"68\",\n      \"buildingName\": \"Vintners Place\",\n      \"postcode\": \"EC4V 3BJ\",\n      \"city\": \"London\",\n      \"region\": \"Greater London\",\n      \"countryCode\": \"GB\"\n    }\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.equalsmoney.com/v2/roqqett/checkout-sessions")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"type\": \"SHOPPING\",\n  \"checkoutId\": \"6f1c2d0e-7a4b-4e2f-9c1d-3b5a7e9f0a12\",\n  \"idempotencyKey\": \"3f9a1c2e-7b4d-4e8a-9c6f-0d2b5a8e1f47\",\n  \"merchantReference\": \"ORDER-10421\",\n  \"amount\": {\n    \"amount\": \"10000.00\",\n    \"currencyCode\": \"GBP\"\n  },\n  \"description\": \"Order ORDER-10421\",\n  \"returnUrl\": \"https://shop.example.com/checkout/complete\",\n  \"locale\": \"en-GB\",\n  \"expiresAt\": \"2026-10-02T13:00:00Z\",\n  \"basket\": {\n    \"items\": [\n      {\n        \"name\": \"Linen shirt\",\n        \"description\": \"Size M, blue\",\n        \"quantity\": 2,\n        \"unitPrice\": {\n          \"amount\": \"10000.00\",\n          \"currencyCode\": \"GBP\"\n        },\n        \"imageUrl\": \"https://shop.example.com/images/shirt.png\"\n      }\n    ]\n  },\n  \"shipping\": {\n    \"amount\": {\n      \"amount\": \"10000.00\",\n      \"currencyCode\": \"GBP\"\n    },\n    \"address\": {\n      \"streetName\": \"Upper Thames Street\",\n      \"buildingNumber\": \"68\",\n      \"buildingName\": \"Vintners Place\",\n      \"postcode\": \"EC4V 3BJ\",\n      \"city\": \"London\",\n      \"region\": \"Greater London\",\n      \"countryCode\": \"GB\"\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.equalsmoney.com/v2/roqqett/checkout-sessions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"type\": \"SHOPPING\",\n  \"checkoutId\": \"6f1c2d0e-7a4b-4e2f-9c1d-3b5a7e9f0a12\",\n  \"idempotencyKey\": \"3f9a1c2e-7b4d-4e8a-9c6f-0d2b5a8e1f47\",\n  \"merchantReference\": \"ORDER-10421\",\n  \"amount\": {\n    \"amount\": \"10000.00\",\n    \"currencyCode\": \"GBP\"\n  },\n  \"description\": \"Order ORDER-10421\",\n  \"returnUrl\": \"https://shop.example.com/checkout/complete\",\n  \"locale\": \"en-GB\",\n  \"expiresAt\": \"2026-10-02T13:00:00Z\",\n  \"basket\": {\n    \"items\": [\n      {\n        \"name\": \"Linen shirt\",\n        \"description\": \"Size M, blue\",\n        \"quantity\": 2,\n        \"unitPrice\": {\n          \"amount\": \"10000.00\",\n          \"currencyCode\": \"GBP\"\n        },\n        \"imageUrl\": \"https://shop.example.com/images/shirt.png\"\n      }\n    ]\n  },\n  \"shipping\": {\n    \"amount\": {\n      \"amount\": \"10000.00\",\n      \"currencyCode\": \"GBP\"\n    },\n    \"address\": {\n      \"streetName\": \"Upper Thames Street\",\n      \"buildingNumber\": \"68\",\n      \"buildingName\": \"Vintners Place\",\n      \"postcode\": \"EC4V 3BJ\",\n      \"city\": \"London\",\n      \"region\": \"Greater London\",\n      \"countryCode\": \"GB\"\n    }\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "id": "0b8e5c3a-2f1d-4c6b-8a9e-7d4f2c1b0a93",
  "type": "SHOPPING",
  "status": "OPEN",
  "checkoutId": "6f1c2d0e-7a4b-4e2f-9c1d-3b5a7e9f0a12",
  "merchantReference": "ORDER-10421",
  "description": "Order ORDER-10421",
  "amount": {
    "amount": "10000.00",
    "currencyCode": "GBP"
  },
  "payeeId": "d2a7c9e1-5b3f-4a8d-9e6c-1f0b2a4c8e57",
  "basket": {
    "items": [
      {
        "name": "Linen shirt",
        "description": "Size M, blue",
        "quantity": 2,
        "unitPrice": {
          "amount": "10000.00",
          "currencyCode": "GBP"
        },
        "imageUrl": "https://shop.example.com/images/shirt.png"
      }
    ]
  },
  "shipping": {
    "amount": {
      "amount": "10000.00",
      "currencyCode": "GBP"
    },
    "address": {
      "streetName": "Upper Thames Street",
      "buildingNumber": "68",
      "buildingName": "Vintners Place",
      "postcode": "EC4V 3BJ",
      "city": "London",
      "region": "Greater London",
      "countryCode": "GB"
    }
  },
  "locale": "en-GB",
  "checkoutUrl": "https://pay.roqqett.com/ch/pay/s/0b8e5c3a-2f1d-4c6b-8a9e-7d4f2c1b0a93",
  "returnUrl": "https://shop.example.com/checkout/complete",
  "paymentId": "9c4e1a7b-3d2f-4b6a-8e5c-0f7d2a9b1c34",
  "orderId": "7e2b9d4a-6c1f-4a5e-8b3d-2f9c0a1e6b78",
  "expiresAt": "2026-10-02T13:00:00Z",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z"
}

{
  "id": "0b8e5c3a-2f1d-4c6b-8a9e-7d4f2c1b0a93",
  "type": "SHOPPING",
  "status": "OPEN",
  "checkoutId": "6f1c2d0e-7a4b-4e2f-9c1d-3b5a7e9f0a12",
  "merchantReference": "ORDER-10421",
  "description": "Order ORDER-10421",
  "amount": {
    "amount": "10000.00",
    "currencyCode": "GBP"
  },
  "payeeId": "d2a7c9e1-5b3f-4a8d-9e6c-1f0b2a4c8e57",
  "basket": {
    "items": [
      {
        "name": "Linen shirt",
        "description": "Size M, blue",
        "quantity": 2,
        "unitPrice": {
          "amount": "10000.00",
          "currencyCode": "GBP"
        },
        "imageUrl": "https://shop.example.com/images/shirt.png"
      }
    ]
  },
  "shipping": {
    "amount": {
      "amount": "10000.00",
      "currencyCode": "GBP"
    },
    "address": {
      "streetName": "Upper Thames Street",
      "buildingNumber": "68",
      "buildingName": "Vintners Place",
      "postcode": "EC4V 3BJ",
      "city": "London",
      "region": "Greater London",
      "countryCode": "GB"
    }
  },
  "locale": "en-GB",
  "checkoutUrl": "https://pay.roqqett.com/ch/pay/s/0b8e5c3a-2f1d-4c6b-8a9e-7d4f2c1b0a93",
  "returnUrl": "https://shop.example.com/checkout/complete",
  "paymentId": "9c4e1a7b-3d2f-4b6a-8e5c-0f7d2a9b1c34",
  "orderId": "7e2b9d4a-6c1f-4a5e-8b3d-2f9c0a1e6b78",
  "expiresAt": "2026-10-02T13:00:00Z",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z"
}

{
  "message": "Checkout session not found.",
  "errors": [
    {
      "path": "string",
      "message": "string",
      "errorCode": "string"
    }
  ]
}

{
  "message": "Checkout session not found.",
  "errors": [
    {
      "path": "string",
      "message": "string",
      "errorCode": "string"
    }
  ]
}

{
  "message": "Checkout session not found.",
  "errors": [
    {
      "path": "string",
      "message": "string",
      "errorCode": "string"
    }
  ]
}