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.

Centra is a headless e-commerce platform that empowers DTC brands to serve advanced e-commerce globally. This section looks at the off-the-shelf integration with Voyado Engage, which is a plugin available in Centra.

​
Connecting your markets to Engage

When setting up the Engage plugin in your store configuration, you can choose to map the Markets in Centra to Stores in Engage. This will help you see from which market you customers were recruited and also the market where the sales were made. By adding “market” to the External store ID field in the configuration, the extension will personalize and use the market name defined per each market as the store.externalId in Engage.
External store ID field
Adjust the spelling of the market name to not have any space characters.

​
Sync of contacts

In Centra you have some configuration options for how to sync your customers to Engage:
How to sync contacts
Choosing this will sync all the customers stored in Centra to the contact type “Member” in Engage.
This option will only sync customers that were created in Centra with the registered flag set to true. Customers will be registered as “Member” in Engage.
All non-registered contacts will be created in Engage as a “Transactional contact” in order to send transactional emails.
This option will only sync the customers created in Centra with a contactId from Engage.
All the customers without a contactId will be created in Engage as a “Transactional contact” in order to send transactional emails.
Toggling this to “Yes” will sync all newsletter subscribers to the contact type “Contact” in Engage.

​
Sync of purchases and returns

Sales are only registered to those customers created as contact type “Member” in Engage. Purchases: A receipt of type “Purchase” is sent to Engage once the order is completed in Centra and ready to be shipped. Returns: A receipt of type “Return” is sent to Engage when a refund has been registered in Centra. This is only applicable if the refund is registered in Centra. If not, then you’ll have to build an integration to the system that holds this information (e.g. ERP)

​
Transactional emails

Out of the box, Centra can trigger four different transactional emails through Engage. All the order and payment states below are configured in Engage and can be filtered in Engage’s marketing automation platform. If a customer already exists in Engage, the transactional email will be triggered to the already existing contact. If not, then Centra will create a Transactional contact and trigger the email send-out.
Purchases and returns are not stored for the contact type “Transactional contact”.
These are the transactional emails that are triggered:
  • Order confirmation
  • Order has been shipped
  • Order has been returned
  • Order has been canceled
Setting up Order Statuses

​
Multichannel promotions

After some front-end development, you’ll be able to assign personal promotions through Engage and connect them to a voucher in Centra. These steps need to be implemented in order to make this work:
  1. The front-end asks Engage if the customer has any active promotions. If so, the front-end takes the external promotion code it got from Engage and checks with Centra what the price rule is for that promotion.
  2. If the customer wants to use one of those promotions then the front-end applies the discount to the purchase (it already knows which price-rule to use).
  3. Once the purchase is completed then the front-end needs to send the promotionId in the purchase payload to Centra.
  4. After interpreting the promotionId Centra redeems the promotion in Engage through a separate API-call once the order is shipped.
Centra will redeem the promotion from Engage if and only if the payment has been successful.

​
Technical documentation

Download a PDF covering the integration with Centra