# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
This site has an agentic ask interface you may use to query the documentation dynamically by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://changelog.shopwaive.com/index.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

---

# What's new at Shopwaive?

Release notes from the Shopwaive team — new features across Checkout, Shopify Flow, AI tools, balances, and the REST API as they ship

#### October 4, 2026

## Shopwaive API keys and export updates

The Shopwaive Development team has released an update to the Shopwaive app, and there is nothing you need to do. Every checkout block, POS tile, Flow action and Flow trigger you already use stays in place, and requests to the Shopwaive API need no change. Developers can now create and revoke their own API keys under <mark style="color:blue;">**Settings**</mark> > <mark style="color:blue;">**Develop**</mark> > <mark style="color:blue;">**Shopwaive API keys**</mark>. <mark style="color:blue;">**Export all balances**</mark> now returns every account, including on very large stores, and <mark style="color:blue;">**Export all transactions**</mark> gives every row the same columns. [Learn more](/posts/quickstart-11)

#### July 1, 2026

## Generative AI — Shopwaive Code

Shopify Plus Dev teams can now connect directly to their GitHub repos to commit to a new or existing branch for code PRs developed with <mark style="color:blue;">**Shopwaive Code**</mark> — from the Built for Shopify admin Shopwaive app. Upload your files and ask Shopwaive to help you troubleshoot errors and complete code review. Need to refactor your PHP codebase to Javascript, format from HTML to React JSX, update your package.json to the latest node engine? No problem. Develop new features, functions, and more with <mark style="color:blue;">**Shopwaive Code**</mark><mark style="color:$info;">.</mark> [<mark style="color:$info;">Learn more</mark>](https://changelog.shopwaive.com/posts/quickstart-10)

#### November 28, 2025

## Send HTTP requests, receive payloads in Flow

The Shopwaive Development team has released a powerful new advanced tool for Flow automations. Teams can now use Shopwaive's new <mark style="color:blue;">**Send HTTP Request**</mark> action to send HTTP requests and receive response payloads with variables that may be used downstream in your Flow. You can make external requests to your endpoints or other 3rd parties, receive a response payload, and define a schema that extracts variables from the response that you can use elsewhere in downstream actions inside. [Learn more](https://docs.shopwaive.com/shopify/shopify-flow#send-http-requests)

#### August 22, 2025

## Generative AI — Videos, Images, and Conversational

Shopify Plus teams can now use Shopwaive's new Generative AI tools to generate images, videos, make edits, ask questions and engage in conversation with Shopwaive's Generative AI.

#### April 7, 2025

## Send customer payloads to Shopify Flow

The Shopwaive Development team has released a powerful new advanced tool for customer profiles. Customer service teams, brand developers, and web development teams can use Shopwaive's new **Send HTTP POST payload** tool on any customer profile page from within the Shopwaive app. Just setup an automation in Shopify Flow, and then trigger it from the customer's profile page.

This feature is designed to mimic an API request to the Shopify Flow environment. Instead of setting up an HTTPS request on your own servers, you simply define your payload body and click **Send payload** to send data inputs to your Shopify Flow automation. Then use Shopify Flow's **Conditional blocks** to design logic and route the automation based on the inputs you sent. All this is made possible using Shopwaive's HTTP POST trigger, which receives the payload you send from the customer's profile page. Simply create any Flow using Shopwaive's **HTTP POST trigger** and any payload you send will be sent to this Flow for processing. [Learn more](https://changelog.shopwaive.com/posts/quickstart-8)

#### April 2, 2025

## Flow action for native Shopify store credit

The Shopwaive Development team is excited to announce release of the native Shopify store credit action for Shopify Flow. This new action is available from the Shopify Flow app and can be paired with the <mark style="color:blue;">**Send email**</mark> Flow action to send an email with the native Store credit amount credited to the customer. The Shopwaive Development team previously released native Shopify store credit features for customer service teams to issue within the Shopwaive Admin app. Now, we've extended this capability to automations in Shopify Flow to unlock powerful work flows that issue credit when new products are purchased and much more. [Learn more](https://help.shopify.com/en/manual/customers/store-credit)

#### March 21, 2025

## Issue and email native Shopify store credit

The Shopwaive Development team has released a new powerful tool that allows customer service teams to issue store credit to customers native Shopify store credit balance, all within the Shopwaive admin app. What's even more? Customer service teams can send a custom branded email with a description of the reason for credit and a backlink to your brand's storefront to encourage redemption.

When customer's receive native Shopify store credit from the Shopwaive app, they can use the convenient <mark style="color:blue;">**Apply store credit**</mark> checkbox at Checkout to redeem. Email templates can be designed and saved in the Shopwaive app with merge tags like <mark style="color:blue;">`{{previous}}`</mark>, <mark style="color:blue;">`{{adjustment}}`</mark>, <mark style="color:blue;">`{{total}}`</mark>, and <mark style="color:blue;">`{{expires}}`</mark> to reference a customer's native Shopify store credit previous balance, adjustment, new balance, and if or when it expires. [Learn more](/posts/quickstart-6)

#### December 9, 2024

## Meet Waive. Shopwaive's AI agent

The Shopwaive Development team has released Waive, Shopwaive's AI agent for accelerated eCommerce growth. Ask Waive anything, like how do I setup Shopwaive's Checkout extensions on Shopify Plus? How do I enable Shopwaive's gift code extension? Where do I change my Shopwaive settings? How do I enable multi-currency support for my Shopwaive extensions? How do I get started with Shopwaive on Shopify POS?

Or perhaps advice on running your business, like Pitch me a go-to-market strategy for our apparel brand on Shopify Plus that desires to increase our D2C sales and retention. What sales channels should we incorporate if our goal is to maximize ROI?

You can even ask general questions about Shopify, like How do I enable Shopify's B2B services? [Learn more](https://docs.shopwaive.com/shopify/shopwaive-ai)

#### November 18, 2024

## Affiliate Referral program

Now, affiliates can earn commission for each order referral and for new customer signups. Affiliates can provide either their unique discount code or referral link to receive commission. Brands can define how much the affiliate earns as a percentage of sales after discounts, and the value of referral discount provided to new customers. Add the New customer accounts app extension to provide affiliates a dedicated dashboard with all their earning metrics, data, and activity [Learn more](https://docs.shopwaive.com/shopify/referrals-and-affiliates)

#### October 23, 2024

## GET Actions API endpoint

The Shopwaive Development team has released a new API endpoint to complement the existing endpoints of the [Action API](https://api.shopwaive.com/reference/rest-api-documentation/action-api). Now, developers can search actions by including any combination of query key value pairs `email`, `created_at_min`, or `created_at_max` appended to the /api/actions request. To get one action by its id, use `GET /api/action/{actionid}`. A maximum of 250 records per request are returned in the response body. [Learn more](https://api.shopwaive.com/reference/rest-api-documentation/action-api#get-actions-endpoint)

#### October 15, 2024

## Group offers at checkout

The Shopwaive Development team has released a new feature for the Offers solution. Brands can now conveniently group offers by similar name by defining a string for the <mark style="color:blue;">**Group offers by similar name**</mark> setting which groups all offers that contain this string. For example, offers earned in a Loyalty program may all contain a title with string "Loyalty".

If customers earn 100s of these deposits, you can group them in a single line at Checkout with the Shopwaive Redeem Checkout extension.

#### September 03, 2024

## Initial change log release

The Shopwaive Development team is rolling out Shopwaive's official Change Log. Developers and merchants can now stay up to date and preview Shopwaive's newest feature releases, API changes, deprecation notices, and sunset schedule.


# Initial change log release

September 03, 2024

The Shopwaive Development team is rolling out Shopwaive's official Change Log. Developers and merchants can now stay up to date and preview Shopwaive's newest feature releases, API changes, deprecation notices, and sunset schedule.


# Cash out options for Shopify Plus

September 13, 2024

{% hint style="warning" %}
Cash Outs is deprecated and is not offered in the Shopwaive app. Questions? Contact <support@shopwaive.com>
{% endhint %}

With Shopwaive, Shopify Plus brands can now offer customers, employees, B2B customers, or vendors maximum flexibility on cash and credit accounts by extending the ability to cash out their credit. Your customers will love this new feature that allows spending their wallet on new merchandise, and with cash out options such as a scheduling a direct deposit to their preferred banking institution and/or debit card on file.

Brands can approve, reject, or refund cash out requests from customers. Additional fees apply.

{% hint style="info" %}
All requests require approval and are routed to the customers' profile page in Shopwaive where you can take action like approve and send funds, reject the request without sending funds, or refund the requested amount to their account if the request was made in error, for example. Note, when a request is made, the amount of the request is frozen and debited from the customers account until you take action
{% endhint %}

{% embed url="<https://storage.googleapis.com/steel-spark-359918.appspot.com/CashOutDemo_Shopwaive.mp4>" %}
Cash out with Shopwaive and Stripe Connect
{% endembed %}


# Group offers at checkout

October 15, 2024

The Shopwaive Development team has released a new feature for the Offers solution. Brands can now conveniently group offers by similar name by defining a string for the <mark style="color:blue;">**Group offers by similar name**</mark> setting which groups all offers that contain this string. For example, offers earned in a Loyalty program may all contain a title with string "Loyalty".

If customers earn 100s of these deposits, you can group them in a single line at Checkout with the Shopwaive Redeem Checkout extension.&#x20;

{% hint style="info" %}
This new feature is convenient when brands choose to use Offers instead of a single digital wallet, since Offers provides a list of earned deposits that customers can choose from and combine in a single checkout. You can combine this with the Collapsible setting for a truly seamless user experience at Checkout
{% endhint %}

<figure><img src="https://311582772-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPSixuUh0CkVLkmb9bg0I%2Fuploads%2FUfJQZbb6iFS3EZXpYGt5%2FGroupOffers.png?alt=media&amp;token=ba63a1db-1e50-4662-b2f8-eef2aac6eadf" alt=""><figcaption><p>New! Brands can group similar offers with the <strong>Group offers by similar name</strong> setting </p></figcaption></figure>


# GET Actions API endpoint

October 23, 2024

The Shopwaive Development team has released a new API endpoint to complement the existing endpoints of the [Action API](https://api.shopwaive.com/reference/rest-api-documentation/action-api). Now, developers can search actions by including any combination of query key value pairs `email`, `created_at_min`, or `created_at_max` appended to the /api/actions request. To get one action by its id, use `GET /api/action/{actionid}`. A maximum of 250 records per request are returned in the response body. [Learn more](https://api.shopwaive.com/reference/rest-api-documentation/action-api#get-actions-endpoint)


# Affiliate Referral program

November 18, 2024

The Shopwaive Development team has released new features to support high-growth brands who need to simplify their affiliate and referral systems. Shopwaive's new solutions include a Commission Structure definition, the [**Earn Commission**](https://docs.shopwaive.com/shopify/referrals-and-affiliates) Shopify Flow action, and a fully dedicated affiliate app extension for New customer accounts. Now, affiliates can earn commission for each order referral and for new customer signups. Affiliates can provide either their unique discount code or referral link to receive commission. Brands can define how much the affiliate earns as a percentage of sales after discounts, and the value of referral discount provided to new customers. [Learn more](https://docs.shopwaive.com/shopify/referrals-and-affiliates)


# Meet Waive. Shopwaive's AI agent

December 9, 2024

The Shopwaive Development team is excited to announce the much anticipated launch of Waive, Shopwaive's powerful AI agent for accelerated eCommerce growth. Ask Waive anything, like how do I setup Shopwaive's Checkout extensions on Shopify Plus? How do I enable Shopwaive's gift code extension? Where do I change my Shopwaive settings? How do I enable multi-currency support for my Shopwaive extensions? How do I get started with Shopwaive on Shopify POS?

Or perhaps advice on running your business, like Pitch me a go-to-market strategy for our apparel brand on Shopify Plus that desires to increase our D2C sales and retention. What sales channels should we incorporate if our goal is to maximize ROI?

You can even ask general questions about Shopify, like How do I enable Shopify's B2B services? [Learn more](https://docs.shopwaive.com/shopify/shopwaive-ai)


# Issue and email native Shopify store credit

March 21, 2025

From popular demand, the Shopwaive Development team has released a new powerful tool that allows customer service teams to issue store credit to customers native Shopify store credit balance, all within the Shopwaive admin app. What's even more? Customer service teams can send a custom branded email with a description of the reason for credit and a backlink to your brand's storefront to encourage redemption.&#x20;

When customer's receive native Shopify store credit from the Shopwaive app, they can use the convenient <mark style="color:blue;">**Apply store credit**</mark> checkbox at Checkout to redeem. Email templates can be designed and saved in the Shopwaive app with merge tags like <mark style="color:blue;">`{{previous}}`</mark>, <mark style="color:blue;">`{{adjustment}}`</mark>, <mark style="color:blue;">`{{total}}`</mark>, and <mark style="color:blue;">`{{expires}}`</mark> to reference a customer's native Shopify store credit previous balance, adjustment, new balance, and if or when it expires, respectively. [Learn more](https://help.shopify.com/en/manual/customers/store-credit)

{% hint style="info" %}
Need support for Shopify Plus integration? Reach out to our team at <support@shopwaive.com> and we'll be glad to support or consider new feature or available options with this release upon request.
{% endhint %}

{% embed url="<https://storage.googleapis.com/steel-spark-359918.appspot.com/TFB_Native.mp4>" %}
New! Issue and email native Shopify store credit with Shopwaive's email editor
{% endembed %}


# Flow action for native Shopify store credit

April 2, 2025

The Shopwaive Development team is excited to announce release of the native Shopify store credit action for Shopify Flow.  This new action is available from the Shopify Flow app and can be paired with the <mark style="color:blue;">**Send email**</mark> Flow action to send an email with the native Store credit amount credited to the customer. The Shopwaive Development team previously released native Shopify store credit features for customer service teams to issue within the Shopwaive Admin app. Now, we've extended this capability to automations in Shopify Flow to unlock powerful work flows that issue credit when new products are purchased and much more. [Learn more](https://help.shopify.com/en/manual/customers/store-credit)

{% hint style="info" %}
Need support for Shopify Plus integration? Reach out to our team at <support@shopwaive.com> and we'll be glad to support or consider new feature or available options with this release upon request.
{% endhint %}

{% embed url="<https://storage.googleapis.com/steel-spark-359918.appspot.com/NativeStoreCredit.mp4>" %}
New! Issue and email native Shopify store credit now with automations in Shopify Flow
{% endembed %}


# Send customer payloads to Shopify Flow

April 7, 2025

The Shopwaive Development team has released a powerful new advanced tool for customer profiles. Customer service teams, brand developers, and web development teams can use Shopwaive's new <mark style="color:blue;">**Send HTTP POST payload**</mark> tool on any customer profile page from within the Shopwaive app. Just setup an automation in Shopify Flow, and then trigger it from the customer's profile page. This feature is meant to mimic an API request to the Shopify Flow environment. Instead of setting up an HTTPS request on your own servers, you simply define your payload body and click <mark style="color:blue;">**Send payload**</mark> to send data inputs to your Shopify Flow automation. Then use Shopify Flow's <mark style="color:blue;">**Conditional blocks**</mark> to design logic and route the automation based on the inputs you sent. All this is made possible using Shopwaive's HTTP POST trigger, which receives the payload you send from the customer's profile page. Simply create any Flow using Shopwaive's <mark style="color:blue;">**HTTP POST trigger**</mark> and any payload you send will be sent to this Flow for processing.

This feature allows you to send discount or gift codes, make changes to Customer metafields, tag customers or orders, and perform any action from 1,000s of app actions available from the Shopify Flow environment. What's even more? Save your favorite automation payloads to send to your Shopify Flow to create quick actions that customer support teams can use to conveniently and efficiently service customers from their profile page in the Shopwaive app.

{% hint style="info" %}
Need support for Shopify Plus integration? Reach out to our team at <support@shopwaive.com> and we'll be glad to support or consider new feature or available options with this release upon request.
{% endhint %}

<figure><img src="https://311582772-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPSixuUh0CkVLkmb9bg0I%2Fuploads%2F8ah10NnTbJdjMA8MrQpy%2FHTTPPOST.png?alt=media&amp;token=79505a53-bcb9-47e4-b7db-05af200522a7" alt=""><figcaption><p>Create a Shopify Flow using Shopwaive's HTTP POST trigger</p></figcaption></figure>

Create payloads and payload templates using any of the variables defined by the HTTP POST trigger

<figure><img src="https://311582772-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPSixuUh0CkVLkmb9bg0I%2Fuploads%2F78m6ot41BBKmR43E6GSC%2FHTTPPOST_variables.png?alt=media&amp;token=ec9141e5-1acd-441a-8eb0-8db748b4151d" alt=""><figcaption><p>For your customer payload, choose to include any of the variables available from the HTTP POST schema</p></figcaption></figure>

In this example, you can send a gift code by email to the customer if you use Shopwaive's <mark style="color:blue;">**Create gift code**</mark> action after Shopwaive's <mark style="color:blue;">**HTTP POST**</mark> trigger. In the <mark style="color:blue;">**Create gift code**</mark> action, you can display the customer's gift code in the email body using `{giftcardcode}`. You can use HTML markup to style the gift code, for example use the following to display the code in bold by copy and pasting it into the **Email Body message** field inside the <mark style="color:blue;">**Create gift code**</mark> action

```
Congrats! Here is your gift code

<span style='font-weight:bold'>{giftcardcode}</span>
```

<figure><img src="https://311582772-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPSixuUh0CkVLkmb9bg0I%2Fuploads%2F2U8nOSJN6NlEN1O6OcV4%2FEmailMessageBody.png?alt=media&amp;token=c74bdf1e-8335-4405-855c-21582bac6a4d" alt=""><figcaption><p>Display the gift code created by the flow in an email to the customer</p></figcaption></figure>

Search for a customer from the Shopwaive app, and click <mark style="color:blue;">**Send HTTP POST to Shopify Flow.**</mark> Then, define a JSON payload to send to your Shopify Flow environment. You can choose to use any fields defined by the HTTP POST trigger's schema

{% embed url="<https://storage.googleapis.com/steel-spark-359918.appspot.com/NewGiftCode.gif>" %}
Search for a customer from the Shopwaive app, and click <mark style="color:blue;">**Send HTTP POST to Shopify Flow**</mark>
{% endembed %}

Choose from any of Shopwaive's <mark style="color:blue;">**HTTP POST**</mark> trigger fields and data types listed below to send in the payload. Choose fields that match your required data type needed in the Shopify Flow environment. `string`, `decimal`, and `boolean` data types are supported. For example, you may choose to use the generic <mark style="color:blue;">**`enabled`**</mark> key to send a type `boolean` to Shopify Flow for downstream processing of your logic. While the values of each key can be any you choose, the schema is strictly enforced and use of only the keys in the payload object below will result in successful delivery to your Shopify Flow environment.

```json

{
    "customerid": "",
    "orderid": "",
    "productid": "",
    "reference": "offer",
    "email": "info@acme.com",
    "number": 0,
    "date": "2028-10-08T02:39:48.591Z",
    "previous": 0,
    "transaction": 85.23,
    "available": 0,
    "collectionid": "",
    "segment": "",
    "note": "",
    "expiration": "",
    "media": "",
    "lineitemid": "",
    "recipient": "customer@gmail.com",
    "template": "",
    "event": "",
    "enabled": true,
    "points": 0,
    "referral": "",
    "recipientname": "John Doe",
    "variant": "41862282936455",
    "type": "type",
    "limit": "limit",
    "version": "version",
    "style": "style",
    "title": "title",
    "group": "group",
    "gid": "gid"
}

```

<figure><img src="https://311582772-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPSixuUh0CkVLkmb9bg0I%2Fuploads%2FWB5IHahaFBCrm0qUuBQV%2FGiftEmail.png?alt=media&amp;token=8f63ae59-f1b7-4d6f-ae7b-c1d22b94bc96" alt=""><figcaption><p>Design your own email template to pixel-perfect match your brand with HTML styling, call-to-action links, images, and more</p></figcaption></figure>

{% hint style="info" %}
To send email with Shopwaive, you'll first need to authenticate your brand's identity and domain by adding records to your DNS settings. [Learn more](https://docs.shopwaive.com/shopify/install/setup-branded-email)
{% endhint %}


# Send HTTP requests, receive responses in Shopify Flow

November 28, 2025

The Shopwaive Development team has released a powerful new advanced tool for Flow automations. Teams can now use Shopwaive's new <mark style="color:blue;">**Send HTTP Request**</mark> action to send HTTP requests and receive response payloads with variables that may be used downstream in your Flow. You can make external requests to your endpoints or other 3rd parties, receive a response payload, and define a schema that extracts variables from the response that you can use elsewhere in downstream actions inside. [Learn more](https://docs.shopwaive.com/shopify/shopify-flow#send-http-requests)

{% hint style="info" %}
Need support for Shopify Plus integration? Reach out to our team at <support@shopwaive.com> and we'll be glad to support or consider new feature or available options with this release upon request.
{% endhint %}

### Send HTTP requests and receive response payloads all within the Flow environment

Follow the tutorial below to learn how to Send HTTP Requests within Shopify Flow and receive a JSON stringified response as variables you can use in downstream actions and conditional blocks.

<figure><img src="https://docs.shopwaive.com/~gitbook/image?url=https%3A%2F%2F1743155819-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F6HSAZj4RDucpQwVtzMYt%252Fuploads%252FALpcKHuf4y7HK01fYZ9O%252FSendHTTPRequest.png%3Falt%3Dmedia%26token%3D4ed018e9-f3b0-43cd-829d-2b457c16b851&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=7596e39d&#x26;sv=2" alt=""><figcaption></figcaption></figure>

With Shopwaive's <mark style="color:blue;">**Send HTTP request**</mark> action, you can make external requests to your endpoints or other 3rd parties, receive a response payload, and define a schema that extracts variables from the response that you can use elsewhere in downstream actions inside Flow.

To get started quickly, import an example <mark style="color:blue;">**Send HTTP request**</mark> Flow [here](https://cdn.shopify.com/s/files/1/0651/7650/2517/files/Send_HTTP_Request.flow?v=1764359742).

Step 1: Choose any trigger that starts the Flow. In our example, we choose <mark style="color:blue;">**Order created**</mark>

Step 2: Add the <mark style="color:blue;">**Send HTTP request**</mark> action in your Flow, add your payload and header to the request

<figure><img src="https://docs.shopwaive.com/~gitbook/image?url=https%3A%2F%2F1743155819-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F6HSAZj4RDucpQwVtzMYt%252Fuploads%252Fj28yXTFSP07bkwRePoyN%252Fpayload.png%3Falt%3Dmedia%26token%3D9f6ef293-a631-475b-ac53-26bf3b26ccb7&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=b1c4ed00&#x26;sv=2" alt=""><figcaption></figcaption></figure>

Step 3: Connect the <mark style="color:blue;">**Send HTTP request**</mark> action to the <mark style="color:blue;">**Run code**</mark> action

Step 4: Use the [example Flow provided above](https://cdn.shopify.com/s/files/1/0651/7650/2517/files/Send_HTTP_Request.flow?v=1764359742) as a reference to fill out the **Run code** action to properly extract data from the payload received. Responses from the <mark style="color:blue;">**Send HTTP request**</mark> action are returned as stringified JSON, so you'll need to use JSON.parse() within the <mark style="color:blue;">**Run code**</mark> action inside the **Write code** block to parse your data into variable schema format. In the example below, we are defining an object schema with arbirtrarily defined fields **`id`**, **`example`**, and **`email`**, but you can define your own. Ensure you use the Define outputs block to correctly define the schema field types.

<figure><img src="https://docs.shopwaive.com/~gitbook/image?url=https%3A%2F%2F1743155819-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F6HSAZj4RDucpQwVtzMYt%252Fuploads%252FjmBkti0ePXNfVzZKjD9v%252FwriteCode.png%3Falt%3Dmedia%26token%3D72f2c280-9f02-4e47-9747-c578a6b2226c&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=f45b32c8&#x26;sv=2" alt=""><figcaption></figcaption></figure>

Step 5: You can now reference your schema as variables such as {{runCode.email}} in downstream Flow actions and conditional blocks

<figure><img src="https://docs.shopwaive.com/~gitbook/image?url=https%3A%2F%2F1743155819-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F6HSAZj4RDucpQwVtzMYt%252Fuploads%252FZtnD5CLtEqkyfwBa6wpv%252FrunCode.png%3Falt%3Dmedia%26token%3Dc9a6a4bb-954c-4c56-b860-f93b1ac72eaa&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=2692b6b6&#x26;sv=2" alt=""><figcaption></figcaption></figure>

If you have any questions, or need support, just reach out to our dev team at <support@shopwaive.com>, we're happy to assist.


# Generative AI — Shopwaive Code

December 1, 2025

Shopify Plus Dev teams can now connect directly to their GitHub repos to commit to a new or existing branch for code PRs developed with <mark style="color:blue;">**Shopwaive Code**</mark> — from the Built for Shopify admin Shopwaive app. Upload your files and ask Shopwaive to help you troubleshoot errors and complete code review. Need to refactor your PHP codebase to Javascript, format from HTML to React JSX, update your package.json to the latest node engine? No problem. Develop new features, functions, and more with <mark style="color:blue;">**Shopwaive Code**</mark>.

{% hint style="info" %}
Need support for Shopify Plus integration? Reach out to our team at <support@shopwaive.com> and we'll be glad to support or consider new feature or available options with this release upon request.
{% endhint %}

### Connect GitHub

First, ensure you've signed up for the **Shopwaive Checkout** subscription plan, as this is required to use Shopwaive Code.

{% hint style="info" %}
Need to upgrade to the **Shopwaive Checkout** subscription plan? In the left side menu of the Shopwaive app within the Shopify admin, open **View more** > **Billing**. Below the billing table, click **Change subscription** (or **View all available subscription plans**, if that is the link you see). On the **Checkout plan** card, click **$60 per month plus usage**, then approve the plan on the Shopify page that opens in a new tab
{% endhint %}

Once you're signed up to the **Shopwaive Checkout** plan, from the Shopwaive app, visit the **Generative AI** menu, click the **Code** tab, and then click the **Install** button in the GitHub card.

<figure><img src="https://311582772-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPSixuUh0CkVLkmb9bg0I%2Fuploads%2FTkRx24sCAslfO4keDBcy%2FInstallGitHub.png?alt=media&amp;token=41a21a89-3b18-4a24-9833-ee862aef76da" alt=""><figcaption><p>Click the Install button to begin an OAuth session with GitHub where you'll select your repos</p></figcaption></figure>

During the GitHub OAuth session that begins, you'll choose which repo(s) you wish to connect to Shopwaive. Before installing, and for the most seamless installation, ensure you've already logged into your GitHub account in the same browser session that you've launched Shopify.

{% hint style="info" %}
Though during installation you'll choose your repo(s) to connect, at anytime, you can visit the Shopwaive Code app in GitHub that you install on your GitHub account to add or remove repo(s)
{% endhint %}

Once you've successfully installed Shopwaive Code on your GitHub account, refresh your Shopify session and the GitHub card will update within the Shopwaive app indicating that your repo(s) have been successfully connected.

<figure><img src="https://311582772-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPSixuUh0CkVLkmb9bg0I%2Fuploads%2FkvLlTTjRhlNh4F1v23sJ%2FShopwaiveCode.png?alt=media&amp;token=954fc181-de44-4e2a-99a8-0cb6b13e8109" alt=""><figcaption><p>The GitHub card will indicate your repo(s) are connected once you complete OAuth</p></figcaption></figure>

Next, you'll get to create code and commit directly to your repo(s). Ask Shopwaive's AI to generate a snippet, a landing page, an integration with Stripe and much more. You can upload files from your code base that you want Shopwaive's AI to debug or help run more efficiently, or refactor into a new language.

<figure><img src="https://311582772-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPSixuUh0CkVLkmb9bg0I%2Fuploads%2FFGCh5XYiw7suH8PDTiMP%2FShopwaiveCodeGenerativeAI.png?alt=media&amp;token=97caf773-0162-4894-8c8b-94c9cf1e4c32" alt=""><figcaption></figcaption></figure>

For example, provide a plain HTML and JS file and ask the AI to refactor into Liquid for your Shopify store. Or provide your Node.js package.json file and ask the AI to update your dependencies. The possibilities are endless.

<figure><img src="https://311582772-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPSixuUh0CkVLkmb9bg0I%2Fuploads%2FErPRh8kmZ7oTFeD8Q6sy%2FCommitToGitHub.png?alt=media&amp;token=641e13d0-d635-43fa-935e-7e79321a3487" alt=""><figcaption></figcaption></figure>

Let Shopwaive make code review and PRs easier than ever before and without expensive AI licenses that charge per seat or request, get access with one subscription to Shopwaive Checkout.

{% hint style="info" %}
Contact <support@shopwaive.com> for more information regarding token allotments and usage, our Billing team can ensure using Shopwaive's AI services are the most cost-effective for your development team
{% endhint %}


# Shopwaive API keys and export updates

October 4, 2026

The Shopwaive Development team has released an update to the Shopwaive app. There is nothing you need to do: every checkout block, POS tile, Flow action and Flow trigger you already use stays in place, there is no new permission to approve, and requests to the Shopwaive API need no change.

{% hint style="info" %}
Questions about this update? Reach out to our team at <support@shopwaive.com>
{% endhint %}

### Shopwaive API keys

Create a key for each developer or integration. Each key can be revoked on its own, without affecting the others.

1. In the Shopwaive app, open <mark style="color:blue;">**Settings**</mark> > <mark style="color:blue;">**Develop**</mark> > <mark style="color:blue;">**Shopwaive API keys**</mark>
2. Type a label, for example `ERP sync`, and click <mark style="color:blue;">**Create key**</mark>
3. Copy the key. It is shown only once

Send the key in the `X-Shopwaive-Access-Token` header, the same header the API has always used. An integration that already sends an access token in that header keeps working, with no change. Use a key for new integrations. [Learn more](https://api.shopwaive.com/quick-start)

### Exports

Both exports are under <mark style="color:blue;">**Customers**</mark> > <mark style="color:blue;">**More actions**</mark>. [Learn more](https://docs.shopwaive.com/shopify/accounts/export-accounts)

* <mark style="color:blue;">**Export all balances**</mark> now returns every account, including on very large stores
* <mark style="color:blue;">**Export all transactions**</mark> now gives every row the same columns in the same order. A column that does not apply to a row is blank
* The transactions file ends with a new `Figures` column. It says where a row's balances come from: `recorded`, `reconstructed`, `derived` or `not recorded`
* An account that holds a balance but has no history is exported as one **Opening balance** row
* Stores with B2B Checkout on also get `Placed By` and `Funded By` after `Email`

### Balance imports

In <mark style="color:blue;">**Customers**</mark> > <mark style="color:blue;">**Import**</mark>, an `Expiry` written as `YYYY-MM-DD` is read as the start of that day in your local time. An `Expiry` that is today or earlier is refused, and nothing is imported until it is corrected. [Learn more](https://docs.shopwaive.com/shopify/accounts/import-accounts)

### Shopify Flow

When Shopify refuses to create the discount or the gift card, the <mark style="color:blue;">**Create discount**</mark> or <mark style="color:blue;">**Create gift code**</mark> step now fails in Flow and shows the reason. The steps after it do not run.

### Shopify POS and gift cards

* The POS tiles now follow the cart's customer. When you change the customer, the tile shows the new customer's balance
* Gift codes no longer need a custom app or a pasted token. The **Gift Cards Access Token** card has been removed from Settings

### For developers

* Merchant-configured webhooks have been retired, and the **Webhooks** section is no longer shown in Settings. To act on a balance change, use the Shopify Flow triggers <mark style="color:blue;">**Balance change**</mark> and <mark style="color:blue;">**Balance changes from order**</mark>