Skip to main content

​
Overview

Our integration with Okendo makes it easy to reward customers for linking accounts and making retail purchases. We’ll show you how to set up your program with Okendo and make the most out of this integration.

​
Get your Okendo credentials

Sign in to your Okendo admin and navigate to Settings -> Integrations -> Credentials. You’ll need two values:
  • User ID — the unique user ID for your store
  • Merchant REST API Key — click Generate to create one
okendo credentials

​
Connect your Okendo account

Sign in to the Subtotal Dashboard and connect your Okendo account to enable the integration. Navigate to Integrations -> Okendo -> Connect. Click the Connect Okendo button. connect okendo Provide your Okendo User ID and Merchant REST API Key, then click Save Integration. set okendo credentials You should now see an Active status on the Okendo integration page. okendo active

​
Configure actions

After connecting, configure the actions Subtotal should send to Okendo. Each action maps a Subtotal event (e.g. an account being linked, a purchase being made) to a custom earning rule you’ve set up in Okendo. okendo integration settings
SettingDescription
Customer identifierThe field on the connection used to identify the customer in Okendo. The Subtotal Okendo integration currently only supports identifying customers by Email.
ActionsOne or more event-to-earning-rule mappings. Each action specifies the event type, retailers it applies to, and the Okendo earning rule ID.
To add an action, click Add action and choose an event: choose an event Each action requires:
FieldDescription
Eventaccount.linked (fired when a customer links a retailer account) or purchase.created (fired for each purchase Subtotal collects).
Action nameA human-readable label for this action.
RetailersRestrict the action to specific retailers, or apply it to all.
Okendo earning rule IDThe Action ID of the custom earning rule you configured in Okendo.
See Rewarding linked accounts and Rewarding purchases for how to set up the matching custom earning rules in Okendo. We use the value passed in the customer_id parameter to identify which customer should be awarded points. Make sure you include the customer_id as a query parameter when you launch Subtotal Link. Check out these resources for more guidance on customer_id: