Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.subtotal.com/llms.txt

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

​
Create a Custom Action in Yotpo

In your Yotpo admin, navigate to Manage Program → Rewards Program → Manage earning rules and click Create earning rule. Choose Custom Action. yotpo custom action Set the Action name (e.g. Made a Purchase). Save the rule. yotpo made a purchase earning rule Keep the Action name value handy — you’ll use the exact same string in the matching Subtotal action.
Subtotal pre-computes the points for each purchase and sends the value to Yotpo, so the points configured on this Yotpo rule are always overridden. You can leave the rule’s points at a placeholder value (e.g. 1) — the actual reward is calculated in Subtotal.

​
Add the action in Subtotal

In the Subtotal Dashboard, navigate to your Yotpo integration and click Add action. Choose purchase.created as the event, and set Action name to the same value you used on your Yotpo Custom Action. Optionally restrict to specific retailers, set Points per dollar, and set a Start date. Subtotal will only reward purchases made on or after the start date — this controls how much historical purchase data gets sent to Yotpo when a customer first links their account. add purchase.created action in subtotal Click Create. Subtotal will now trigger the matching Custom Action in Yotpo for each qualifying purchase it collects.
Subtotal computes the point value for each purchase as ceil(items_subtotal × points_per_dollar) — where items_subtotal is the sum of price × quantity for each item Subtotal collects from the receipt — and sends the resulting integer to Yotpo as reward_points. Taxes, shipping, and other fees are not included. One Yotpo custom action event is posted per qualifying purchase.