Skip to main content
PUT
/
v1
/
orders
Update orders
curl --request PUT \
  --url https://api.quickbutik.com/v1/orders \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
[
  [
    {
      "order_id": "948102",
      "status": "done",
      "shipping_info": {
        "trackingnumber": "230491712300",
        "company": "DHL"
      },
      "email_confirmation": "true",
      "paymethod_activate": "true",
      "skip_email_confirmation": "false",
      "skip_webhook": "false",
      "language": "en",
      "products_add": [
        {
          "sku": "SHIRT-123",
          "product_id": "12345",
          "variant_id": "67890",
          "qty": 1
        }
      ],
      "products_remove": [
        {
          "sku": "OLD-SHIRT-001",
          "qty": 1
        }
      ],
      "products": [
        {
          "sku": "SHIRT-123",
          "product_id": "12345",
          "variant_id": "67890",
          "qty": 2
        }
      ],
      "discount_add": {
        "amount": 50
      },
      "discount_remove": false,
      "customer": {
        "type": "consumer",
        "email": "customer@example.com",
        "phone": "+46701234567",
        "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": ""
        },
        "note": "Leave at the front door"
      },
      "payment": {
        "method": "MySaleChannel",
        "transaction_id": "TX-2024-0001",
        "currency": "SEK"
      },
      "shipping": {
        "id": 1,
        "name": "Postnord Parcel",
        "price": "49.00"
      },
      "metadata": {
        "external_ref": "ERP-55213"
      }
    }
  ]
]
'
{
  "results": {}
}

Documentation Index

Fetch the complete documentation index at: https://quickbutik.dev/llms.txt

Use this file to discover all available pages before exploring further.

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

ID of the order to update. Required.

Example:

"948102"

​
status
enum<string>

Change the order state.

Available options:
paid,
done,
cancelled,
unpaid
Example:

"paid"

​
shipping_info
object

Optional. Used together with status done to attach tracking information to the shipment.

​
email_confirmation
string

Optional. Used together with status done — send shipping confirmation email to customer.

Example:

"true"

​
skip_email_confirmation
string

Optional. Used together with status paid — skip the order confirmation email.

Example:

"true"

​
paymethod_activate
string

Optional. Used together with status done. Default is true.

Example:

"false"

​
skip_webhook
string

Optional. Used together with status paid — skip webhook notifications for this status change.

Example:

"true"

​
language
string

Optional. Used together with status paid. Two-letter language code (ISO 639-1) used for customer-facing emails.

Example:

"en"

​
products
object[]

Specify products in this order. When used, all other existing products in the order will be removed and be replaced with the ones specified here

​
products_add
object[]

Optional. If you would like to add products from the order. You can pass multiple objects/products into this parameter, to add multiple at once

​
products_remove
object[]

Optional. If you would like to remove products from the order. You can pass multiple objects/products into this parameter, to remove multiple at once

​
discount_add
object

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

​
discount_remove
boolean

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

​
customer
object

Optional. Update customer details on the order.

​
payment
object

Optional. Update payment details on the order.

​
shipping
object

Optional. Update the shipping method on the order.

​
metadata
object

Optional. Custom metadata to set on the order. Existing keys are overwritten, others are left in place.

Response

Orders updated successfully

​
results
object