Skip to main content
POST
/
v1
/
orders
Create orders
curl --request POST \
  --url https://api.quickbutik.com/v1/orders \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
[
  [
    {
      "order_id": "create",
      "customer": {
        "type": "consumer",
        "email": "customer@example.com",
        "phone": "+46701234567",
        "login_create": false,
        "newsletter_subscribe": true,
        "note": "Leave at the front door",
        "billing_details": {
          "firstname": "Kalle",
          "lastname": "Ankasson",
          "address": "Gladagatan 10",
          "address2": "",
          "city": "Ankeborg",
          "zipcode": "12345",
          "country": "SE"
        },
        "shipping_details": {
          "firstname": "Kalle",
          "lastname": "Ankasson",
          "address": "Gladagatan 10",
          "address2": "",
          "city": "Ankeborg",
          "zipcode": "12345",
          "country": "SE",
          "company_name": ""
        }
      },
      "payment": {
        "method": "MySaleChannel",
        "transaction_id": "TX-2024-0001",
        "currency": "SEK",
        "log": "Paid via external sales channel"
      },
      "shipping": {
        "id": 1,
        "name": "Postnord Parcel",
        "price": 49
      },
      "products": [
        {
          "product_id": 12345,
          "variant_id": 67890,
          "sku": "SHIRT-123",
          "qty": 2,
          "price": 199
        }
      ],
      "discount_add": {
        "amount": 50
      },
      "metadata": {
        "external_ref": "ERP-55213"
      }
    }
  ]
]
'
import requests

url = "https://api.quickbutik.com/v1/orders"

payload = [[
        {
            "order_id": "create",
            "customer": {
                "type": "consumer",
                "email": "customer@example.com",
                "phone": "+46701234567",
                "login_create": False,
                "newsletter_subscribe": True,
                "note": "Leave at the front door",
                "billing_details": {
                    "firstname": "Kalle",
                    "lastname": "Ankasson",
                    "address": "Gladagatan 10",
                    "address2": "",
                    "city": "Ankeborg",
                    "zipcode": "12345",
                    "country": "SE"
                },
                "shipping_details": {
                    "firstname": "Kalle",
                    "lastname": "Ankasson",
                    "address": "Gladagatan 10",
                    "address2": "",
                    "city": "Ankeborg",
                    "zipcode": "12345",
                    "country": "SE",
                    "company_name": ""
                }
            },
            "payment": {
                "method": "MySaleChannel",
                "transaction_id": "TX-2024-0001",
                "currency": "SEK",
                "log": "Paid via external sales channel"
            },
            "shipping": {
                "id": 1,
                "name": "Postnord Parcel",
                "price": 49
            },
            "products": [
                {
                    "product_id": 12345,
                    "variant_id": 67890,
                    "sku": "SHIRT-123",
                    "qty": 2,
                    "price": 199
                }
            ],
            "discount_add": { "amount": 50 },
            "metadata": { "external_ref": "ERP-55213" }
        }
    ]]
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

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

print(response.text)
const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify([
    [
      {
        order_id: 'create',
        customer: {
          type: 'consumer',
          email: 'customer@example.com',
          phone: '+46701234567',
          login_create: false,
          newsletter_subscribe: true,
          note: 'Leave at the front door',
          billing_details: {
            firstname: 'Kalle',
            lastname: 'Ankasson',
            address: 'Gladagatan 10',
            address2: '',
            city: 'Ankeborg',
            zipcode: '12345',
            country: 'SE'
          },
          shipping_details: {
            firstname: 'Kalle',
            lastname: 'Ankasson',
            address: 'Gladagatan 10',
            address2: '',
            city: 'Ankeborg',
            zipcode: '12345',
            country: 'SE',
            company_name: ''
          }
        },
        payment: {
          method: 'MySaleChannel',
          transaction_id: 'TX-2024-0001',
          currency: 'SEK',
          log: 'Paid via external sales channel'
        },
        shipping: {id: 1, name: 'Postnord Parcel', price: 49},
        products: [{product_id: 12345, variant_id: 67890, sku: 'SHIRT-123', qty: 2, price: 199}],
        discount_add: {amount: 50},
        metadata: {external_ref: 'ERP-55213'}
      }
    ]
  ])
};

fetch('https://api.quickbutik.com/v1/orders', 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.quickbutik.com/v1/orders",
  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([
    [
        [
                'order_id' => 'create',
                'customer' => [
                                'type' => 'consumer',
                                'email' => 'customer@example.com',
                                'phone' => '+46701234567',
                                'login_create' => false,
                                'newsletter_subscribe' => true,
                                'note' => 'Leave at the front door',
                                'billing_details' => [
                                                                'firstname' => 'Kalle',
                                                                'lastname' => 'Ankasson',
                                                                'address' => 'Gladagatan 10',
                                                                'address2' => '',
                                                                'city' => 'Ankeborg',
                                                                'zipcode' => '12345',
                                                                'country' => 'SE'
                                ],
                                'shipping_details' => [
                                                                'firstname' => 'Kalle',
                                                                'lastname' => 'Ankasson',
                                                                'address' => 'Gladagatan 10',
                                                                'address2' => '',
                                                                'city' => 'Ankeborg',
                                                                'zipcode' => '12345',
                                                                'country' => 'SE',
                                                                'company_name' => ''
                                ]
                ],
                'payment' => [
                                'method' => 'MySaleChannel',
                                'transaction_id' => 'TX-2024-0001',
                                'currency' => 'SEK',
                                'log' => 'Paid via external sales channel'
                ],
                'shipping' => [
                                'id' => 1,
                                'name' => 'Postnord Parcel',
                                'price' => 49
                ],
                'products' => [
                                [
                                                                'product_id' => 12345,
                                                                'variant_id' => 67890,
                                                                'sku' => 'SHIRT-123',
                                                                'qty' => 2,
                                                                'price' => 199
                                ]
                ],
                'discount_add' => [
                                'amount' => 50
                ],
                'metadata' => [
                                'external_ref' => 'ERP-55213'
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>",
    "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.quickbutik.com/v1/orders"

	payload := strings.NewReader("[\n  [\n    {\n      \"order_id\": \"create\",\n      \"customer\": {\n        \"type\": \"consumer\",\n        \"email\": \"customer@example.com\",\n        \"phone\": \"+46701234567\",\n        \"login_create\": false,\n        \"newsletter_subscribe\": true,\n        \"note\": \"Leave at the front door\",\n        \"billing_details\": {\n          \"firstname\": \"Kalle\",\n          \"lastname\": \"Ankasson\",\n          \"address\": \"Gladagatan 10\",\n          \"address2\": \"\",\n          \"city\": \"Ankeborg\",\n          \"zipcode\": \"12345\",\n          \"country\": \"SE\"\n        },\n        \"shipping_details\": {\n          \"firstname\": \"Kalle\",\n          \"lastname\": \"Ankasson\",\n          \"address\": \"Gladagatan 10\",\n          \"address2\": \"\",\n          \"city\": \"Ankeborg\",\n          \"zipcode\": \"12345\",\n          \"country\": \"SE\",\n          \"company_name\": \"\"\n        }\n      },\n      \"payment\": {\n        \"method\": \"MySaleChannel\",\n        \"transaction_id\": \"TX-2024-0001\",\n        \"currency\": \"SEK\",\n        \"log\": \"Paid via external sales channel\"\n      },\n      \"shipping\": {\n        \"id\": 1,\n        \"name\": \"Postnord Parcel\",\n        \"price\": 49\n      },\n      \"products\": [\n        {\n          \"product_id\": 12345,\n          \"variant_id\": 67890,\n          \"sku\": \"SHIRT-123\",\n          \"qty\": 2,\n          \"price\": 199\n        }\n      ],\n      \"discount_add\": {\n        \"amount\": 50\n      },\n      \"metadata\": {\n        \"external_ref\": \"ERP-55213\"\n      }\n    }\n  ]\n]")

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

	req.Header.Add("Authorization", "Basic <encoded-value>")
	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.quickbutik.com/v1/orders")
  .header("Authorization", "Basic <encoded-value>")
  .header("Content-Type", "application/json")
  .body("[\n  [\n    {\n      \"order_id\": \"create\",\n      \"customer\": {\n        \"type\": \"consumer\",\n        \"email\": \"customer@example.com\",\n        \"phone\": \"+46701234567\",\n        \"login_create\": false,\n        \"newsletter_subscribe\": true,\n        \"note\": \"Leave at the front door\",\n        \"billing_details\": {\n          \"firstname\": \"Kalle\",\n          \"lastname\": \"Ankasson\",\n          \"address\": \"Gladagatan 10\",\n          \"address2\": \"\",\n          \"city\": \"Ankeborg\",\n          \"zipcode\": \"12345\",\n          \"country\": \"SE\"\n        },\n        \"shipping_details\": {\n          \"firstname\": \"Kalle\",\n          \"lastname\": \"Ankasson\",\n          \"address\": \"Gladagatan 10\",\n          \"address2\": \"\",\n          \"city\": \"Ankeborg\",\n          \"zipcode\": \"12345\",\n          \"country\": \"SE\",\n          \"company_name\": \"\"\n        }\n      },\n      \"payment\": {\n        \"method\": \"MySaleChannel\",\n        \"transaction_id\": \"TX-2024-0001\",\n        \"currency\": \"SEK\",\n        \"log\": \"Paid via external sales channel\"\n      },\n      \"shipping\": {\n        \"id\": 1,\n        \"name\": \"Postnord Parcel\",\n        \"price\": 49\n      },\n      \"products\": [\n        {\n          \"product_id\": 12345,\n          \"variant_id\": 67890,\n          \"sku\": \"SHIRT-123\",\n          \"qty\": 2,\n          \"price\": 199\n        }\n      ],\n      \"discount_add\": {\n        \"amount\": 50\n      },\n      \"metadata\": {\n        \"external_ref\": \"ERP-55213\"\n      }\n    }\n  ]\n]")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.quickbutik.com/v1/orders")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "[\n  [\n    {\n      \"order_id\": \"create\",\n      \"customer\": {\n        \"type\": \"consumer\",\n        \"email\": \"customer@example.com\",\n        \"phone\": \"+46701234567\",\n        \"login_create\": false,\n        \"newsletter_subscribe\": true,\n        \"note\": \"Leave at the front door\",\n        \"billing_details\": {\n          \"firstname\": \"Kalle\",\n          \"lastname\": \"Ankasson\",\n          \"address\": \"Gladagatan 10\",\n          \"address2\": \"\",\n          \"city\": \"Ankeborg\",\n          \"zipcode\": \"12345\",\n          \"country\": \"SE\"\n        },\n        \"shipping_details\": {\n          \"firstname\": \"Kalle\",\n          \"lastname\": \"Ankasson\",\n          \"address\": \"Gladagatan 10\",\n          \"address2\": \"\",\n          \"city\": \"Ankeborg\",\n          \"zipcode\": \"12345\",\n          \"country\": \"SE\",\n          \"company_name\": \"\"\n        }\n      },\n      \"payment\": {\n        \"method\": \"MySaleChannel\",\n        \"transaction_id\": \"TX-2024-0001\",\n        \"currency\": \"SEK\",\n        \"log\": \"Paid via external sales channel\"\n      },\n      \"shipping\": {\n        \"id\": 1,\n        \"name\": \"Postnord Parcel\",\n        \"price\": 49\n      },\n      \"products\": [\n        {\n          \"product_id\": 12345,\n          \"variant_id\": 67890,\n          \"sku\": \"SHIRT-123\",\n          \"qty\": 2,\n          \"price\": 199\n        }\n      ],\n      \"discount_add\": {\n        \"amount\": 50\n      },\n      \"metadata\": {\n        \"external_ref\": \"ERP-55213\"\n      }\n    }\n  ]\n]"

response = http.request(request)
puts response.read_body
{
  "results": {}
}
{
  "code": 404,
  "error": "Resource not found"
}
{
  "code": 404,
  "error": "Resource not found"
}

Authorizations

​
Authorization
string
header
required

Basic Authentication with API Keys

The Quickbutik API uses Basic Authentication where you use your API key as both the username and password.

How it works:

  1. Format your credentials as api_key:api_key (using the SAME API key for both username and password)
  2. Base64 encode the formatted string
  3. Include in the Authorization header as: Authorization: Basic ENCODED_STRING

Example:

  • API Key: sk_live_abc123
  • Formatted: sk_live_abc123:sk_live_abc123
  • Base64 Encoded: c2tfbGl2ZV9hYmMxMjM6c2tfbGl2ZV9hYmMxMjM=
  • Header: Authorization: Basic c2tfbGl2ZV9hYmMxMjM6c2tfbGl2ZV9hYmMxMjM=

cURL Example:

curl https://api.quickbutik.com/v1/orders -u your_api_key:your_api_key

All API requests must be made over HTTPS. Requests made over HTTP will be rejected.

API keys can be generated in the Quickbutik Control Panel under Settings → API.

Body

application/json
​
order_id
string
required

Must be the value create to create a new order.

Example:

"create"

​
customer
object
required

Customer details for the new order.

​
payment
object
required

Payment information for the new order.

​
products
object[]
required

Products to add to the order. Required when creating an order.

​
shipping
object

Shipping method for the new order.

​
discount_add
object

Optional. Set only if you would like to add a discount for this order

​
metadata
object

Custom metadata for the order

Response

Order created successfully

​
results
object

Results object containing response for each order creation attempt. Keys are dynamically generated as create_1, create_2, etc.