REST API documentation
Dive into the specifics of each REST API endpoint, example snippets, and version release notes to setup a sandbox and make your first requests
2024-11 Release Notes
What's new in 2024-11
The 2024-11 version of Shopwaive's APIs includes the following highlights:
Action API
The GET Actions /api/actions endpoint is now part of the Action API, a new endpoint that allows developers to search and filter actions beyond the existing single action endpoint /api/action/{action id}. With the new endpoint, search actions by including any combination of query key value pairs id,email,created_at_min, or created_at_max appended to the /api/actions request. A maximum of 250 records per request are returned in the response body. Learn more
2024-05 Release Notes
What's new in 2024-05
The 2024-05 version of Shopwaive's APIs includes the following highlights:
Customer API
Response body of Customer API GET requests now include an option for returning a customer's orders through the orders array by appending ?orders=true to the request url.
Response body of Customer API GET requests now return an abridged version of the customer's full account meta data, and do not include activity or orders arrays by default. To include these additional arrays in the response body, append optional query parameters ?activity=true or ?orders=true to the request url.
The transaction field included in the activity array and action object is deprecated and has been sunset beginning April 1, 2024. Requests to the Customer API should not depend on the field being included in the response body.
expirationdate and expires fields can now be included in the request body to the Customer API PUT and POST endpoints. Enable multiple expiry dates to create powerful promotional offers that expire on different dates and with their own eligibility rules and requirements.
referralurl is now returned if your Referral program is enabled. Learn more about Shopwaive's powerful Referral program for customers and affiliates. If new customers sign up using the referral link, you can choose to reward one or both the referrer and new customer
Action API
The Action API is a new resource available with the 2024-05 release of Shopwaive's REST API. Developers can issue segments of credit with independent expiration and eligibility, and include these offers at Checkout with Shopwaive's Checkout Extension for Shopify Plus. The top-level account balance expiration date, if set, overrides any segment-level credit expiration.
Overview
The Shopwaive REST API includes the Customer, Order, and Action APIs
Customer API
Customer API provides developers ability to query, increment, and set customer balances.
Action API
Action API provides developers ability to query, update expirations and meta data, and delete action properties.
Order API
Create a checkout url link you can direct your customers to with store credit applied, and optionally include combined line item discounts.
Good to know: Developers use the Order API to create a fully custom checkout experience. With Shopwaive's Order API, you can apply credit to an order, set line items and quantities, and apply discounts to each line item (optional). Use cases include automation of custom invoice creation based on customer credit accounts balances, promos, and account activation requests that include checkout preview links with credit automatically applied.
Last updated