Order API

Create Shopify orders with store credit automatically applied with the Shopwaive Order API

Good to know: This API method provides developers the ability to expedite cart creation with a direct link to checkout with stacked discounts (i.e. line items discounted with promo and store credit applied). Gift cards can also be optionally applied at checkout.

GET orders endpoint

Search and filter customer orders by including any combination of query key value pairs id,email,created_at_min, or created_at_max appended to the /api/orders endpoint. A maximum of 250 records per request are returned in the response body. Dates should use ISOString format when appended as a query string, for example, new Date().toISOString().

// Example date and email constrained request

https://app.shopwaive.com/api/orders?email=[e-mail]&created_at_min=2024-09-22T04:51:20.144Z&created_at_max=2024-09-22T19:14:22.688Z

Get orders

get

/api/orders

Authorizations

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://app.shopwaive.com/api/orders' \
  --header 'X-Shopwaive-Access-Token: YOUR_API_KEY'

200

default

200

[]

Successfully fetched orders

POST order endpoint

Create customer order

post

/api/order

Authorizations

Body

customeridnumberrequired

Example: 6659662610648

free_shippingboolean

Example: true

tagsstring

Example: New customer, Store Credit, Marketing promo, Exclusive

descriptionstringrequired

Example: Store Credit

amountnumberrequired

Example: 450

order_notesobject[]

cartobject[]required

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://app.shopwaive.com/api/order' \
  --header 'X-Shopwaive-Access-Token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"customerid":"6659662610648","free_shipping":true,"tags":"New customer, Store Credit, Marketing promo, Exclusive","description":"Store Credit","amount":"450","order_notes":[],"cart":[]}'

200

default

200

{
  "status": "success",
  "checkout_url": "https://example.myshopify.com/60557656280/invoices/b187f60bbb34efd05d15233cdfba5b84"
}

Successfully created customer checkout url

Header

key	value
X-Shopwaive-Access-Token	Store's platform API key for store (required)
X-Shopwaive-Platform	Store's platform (required)
Content-Type	Content type

Request Body

key	value
customerid	Customer id associated with store's platform
free_shipping	Boolean
tags	Tags to apply to order
order_notes	Additional details or notes to apply to order
description	Description of credit applied (i.e. Store Credit)
amount	Amount of credit to apply to order
cart	Customer cart associated with order

Response Body

key	value
status	Status message
checkout_url	Checkout url to be used by customer for payment