Skip to main content

Documentation Index

Fetch the complete documentation index at: https://partner-integrations.voyado.com/llms.txt

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

Here you’ll find the changes and updates to the Voyado Engage app for Shopify. There is an RSS feed for this page allowing you to subscribe to changes as they are published.
https://mintcdn.com/voyado-partners/0IxEIB2Y6a--gNYY/icons/partner-integrations-link.png?fit=max&auto=format&n=0IxEIB2Y6a--gNYY&q=85&s=f3f7d94d9be6a06ca87acc84e4d5c032

Show me the RSS feed

2025-07-14

App disabled when invalid API key used

With this update, the app automatically disables itself when it encounters an invalid or deleted API key. To resume syncing, merchants need to reconnect the app with a valid API key. Previously, if a customer’s API key was revoked (for example, after they churn), the app would remain active and would need to be manually uninstalled.

Skip customers without email in POS orders

POS orders that include a customer who doesn’t have an email address are now filtered out, preventing errors.

Improved handling of refunds for unfulfilled orders

Previously, syncing a refund for an order that had not yet reached the specified receipt-sync stage would cause the error: “Cannot handle refund due to related order not being synced.” This has now been addressed, aligning refund behavior with the expected syncing logic, which is:
  • If receipt-sync stage is set to “Fulfilled” the app ignores the refund until the order is fully fulfilled
  • If receipt-sync stage is set to “Unfulfilled” the app syncs the refund immediately

Fallback store optional in store-to-country mapping

A customer without a specific Engage store will now sync. The “Recruited in store” field will be left empty instead of blocking the sync. Previously, if a customer’s country wasn’t mapped to a store in Engage, and no fallback store was configured, the app would return a validation error.
If no fallback store is set, orders from unmapped countries won’t sync. Be sure to map all shipping countries or else define a fallback store to avoid missing data.
2025-03-31

Shopify app now uses GraphQL

GraphQL is a flexible and modern way to retrieve data from an API, allowing faster syncing and smaller data loads. You will need to go into Shopify and update your Voyado Engage app before April 1st to avoid any issues.

Read about the update to GraphQL

2025-03-17

New UI extensions

The app’s POS UI extensions were upgraded to Shopify’s new Unified UI Extension Package, improving performance and maintainability, and giving access to the latest Shopify extension features.

Read more about the Unified UI Extension Package

Admin action extension

The existing admin link has been migrated to an Admin Action Extension for a more integrated experience within Shopify Admin.

See more on admin action extensions

Script tag upgrade

Shopify is moving away from script tags, requiring users to move from the checkout_complete event to the Web Pixel API’s checkout_completed event. The cr parameter sent to Engage has also been adjusted to exclude thekey attribute from the cartToken, ensuring consistency across all pixel events.

See more on the script tag changes

2024-11-01

New lang attribute

Added instructions for updating contacts to use the new lang attribute.
https://mintcdn.com/voyado-partners/0IxEIB2Y6a--gNYY/icons/developer-link.png?fit=max&auto=format&n=0IxEIB2Y6a--gNYY&q=85&s=36f1df27b0269657d842f3301d440083

See about the lang attribute here

2024-10-17

Handling of zero-value refunds

Added handling of refunds with an amount of 0.
https://mintcdn.com/voyado-partners/0IxEIB2Y6a--gNYY/icons/partner-integrations-link.png?fit=max&auto=format&n=0IxEIB2Y6a--gNYY&q=85&s=f3f7d94d9be6a06ca87acc84e4d5c032

See more about syncing receipts

2024-06-28

Web pixel tracking update

Web pixel tracking now allows identification in checkout by email.
https://mintcdn.com/voyado-partners/0IxEIB2Y6a--gNYY/icons/partner-integrations-link.png?fit=max&auto=format&n=0IxEIB2Y6a--gNYY&q=85&s=f3f7d94d9be6a06ca87acc84e4d5c032

See more about web pixel tracking

2024-01-23

Task monitoring overview

Task monitoring overview page and config panel added.
https://mintcdn.com/voyado-partners/0IxEIB2Y6a--gNYY/icons/partner-integrations-link.png?fit=max&auto=format&n=0IxEIB2Y6a--gNYY&q=85&s=f3f7d94d9be6a06ca87acc84e4d5c032

See more about task monitoring overview

2024-01-09

Setup and configuration additions

New sections were added to the setup and configuration guide:
  • Headless API keys
  • Synchronize marketing preferences
  • Synchronize marketing preference changes from Shopify orders
https://mintcdn.com/voyado-partners/0IxEIB2Y6a--gNYY/icons/partner-integrations-link.png?fit=max&auto=format&n=0IxEIB2Y6a--gNYY&q=85&s=f3f7d94d9be6a06ca87acc84e4d5c032

See the setup and configuration guide

2023-12-07

Headless loyalty API

Headless loyalty API added, for displaying loyalty information without using the Shopify front-end.
https://mintcdn.com/voyado-partners/0IxEIB2Y6a--gNYY/icons/partner-integrations-link.png?fit=max&auto=format&n=0IxEIB2Y6a--gNYY&q=85&s=f3f7d94d9be6a06ca87acc84e4d5c032

Read about the loyalty API

2023-12-01

Shopify POS integration

Shopify POS integration moved out of beta.

UI update

New UI released for the Voyado Engage app.
2023-10-16

Shopify POS integration

The Shopify POS integration was released.
https://mintcdn.com/voyado-partners/0IxEIB2Y6a--gNYY/icons/partner-integrations-link.png?fit=max&auto=format&n=0IxEIB2Y6a--gNYY&q=85&s=f3f7d94d9be6a06ca87acc84e4d5c032

See Shopify POS articles

2023-10-05

PARTIALLY_FULFILLED state

Transactional state PARTIALLY_FULFILLED was added.

Abandoned browse

Abandoned browse now works out-of-the-box.
2023-09-28

Change in handling of receipt number

Receipt number in Engage is now connected to order.name from Shopify instead of order.number.
This will not affect already imported orders. Merchants with already imported orders should use the search term “Contains” when segmenting in Engage on specific order number or receipt numbers.
Some merchants may not be affected by this at all since order number and order name can be the same in Shopify. The main change then is a suffix added to the number. Example: “12345” becomes “12345VOY”.

Cancelled order update

A cancelled order no longer triggers a refund email.
2023-09-13

Migration of orders

Added migration of orders for customers who were imported to Engage outside of the Shopify app. For example, through a CSV file import in Engage.

Consents handled correctly in checkout

The “Accepts email” flag / consent in Engage is now updated correctly when completing checkout in Shopify.

Validation mismatch fixed

The validation mismatch on orders within the app has now been resolved. Previously, order totals did not match those in Shopify and were therefore not imported.

Error handling improvement

Better error handling of error message 409 - ContactWithKeyIsBeingCreated.

Fix for zero-discount entries

When syncing orders, any zero-discount entries will now not be sent to Engage.
2023-08-15

Products of interest

Products of interest now sent to Engage.

Migration added

Migration of customers and orders added.
2023-07-01

Assigning of vouchers and promotions

Assigning vouchers and promotions in Engage for use in Shopify.
2023-06-01

Abandoned cart added

Triggering of abandoned cart actions in Engage.
2023-01-27

Contacts sync

Sync of contacts between Engage and Shopify.

Transactional communication

Transactional communication now sent out from Engage.

Orders sent

Orders (receipts), both purchase and return, sent to Engage.

App theme block

App theme block in Shopify showing customer’s available vouchers and promotions.

Redemption added

Redeeming of promotions and vouchers.

Soft identification added

Soft identification (also called soft ID) added to app.