Integration examples

Platform integrations

Ready-made plugins for Shopify, WooCommerce, and Magento. Install one, set your API key and which events to track, and purchases and signups start earning points automatically.

Same identity model everywhere

Every plugin identifies shoppers by email (order billing email, or account email for signups), not by the platform's own internal customer id. This also means guest checkouts are tracked, since no platform account is required.

Shopify

An embedded Shopify app built with Remix. Merchants configure it from a settings page inside the Shopify admin, no code required.

Setting	Description
Mode	Production or Development, controls which Solary API the app talks to.
API key	Your company's Solary API key.
Enabled events	Purchase and/or signup.
Signup points	Fixed points awarded when a customer account is created.
Purchase points multiplier	Points = round(order total × multiplier).

Behind the scenes, the app listens to the orders/create and customers/create webhooks and sends a purchase_completed or signup_completed event for each one.

WooCommerce

A WordPress plugin, configured under WooCommerce, Settings, Solary.

Setting	Description
Mode	Production or Development.
Enabled events	Purchase and/or signup.
API key	Your company's Solary API key.
Signup points	Fixed points on account creation, default 500.
Purchase points multiplier	Default 1.00, applied to the order total including tax and shipping.

Purchases are tracked on woocommerce_order_status_completed, woocommerce_thankyou, and woocommerce_checkout_order_processed. Signups on user_register and woocommerce_created_customer. Both are de-duplicated with order and user meta so an event is never sent twice.

Magento

A Magento 2 module, configured under Stores, Configuration, Solary Events, General Settings.

Setting	Description
Mode	Production or Development.
API key	Your company's Solary API key.
Use signup event? / Use purchase event?	Toggle each event on or off independently.
Signup points	Fixed points on account creation, default 500.
Purchase points multiplier	Default 1.00, applied to the order's grand total.

Purchases are tracked via the sales_order_place_after observer, signups via customer_register_success.

Something custom?

If you're on a platform without a ready-made plugin, use one of the server SDKs (Node.js, PHP, Go, Python) or call the events API directly from wherever your order and signup logic already lives.

Events API Security & privacy