The Talon One Loyalty connector activates pending Talon One loyalty points when an order ships. When a fulfillment is created in the app, the connector reads the Talon One loyalty details saved on the order and asks Talon One to activate the points for the items that shipped. You don’t need to set up field mapping.
With this connector, you can:
- Activate pending loyalty points in Talon One automatically as orders ship, checked every 5 minutes.
- Activate points for each item when that item ships, and order-level points when the whole order has shipped.
- Activate points again for specific orders on demand.
- See an exception on any fulfillment whose points Talon One couldn’t activate.
Setup
Before you begin, make sure you have:
- The connector turned on for your organization. This connector is in beta, so submit a support request to turn it on.
- A Talon One account with a loyalty program that creates pending points at checkout.
- Your Talon One base URL for your region, for example
https://<your-endpoint>.talon.one, with no trailing slash. - A Talon One integration API key that can activate loyalty points.
- Orders that carry the Talon One loyalty details from checkout in the
talon_one_session_effectscustom field. Your storefront must pass these to the app with the order.
The Connect pop-up also shows a link to request assistance. If you need help, use it, and the Pipe17 support team helps you configure the connection.
To connect Talon One Loyalty:
- Navigate to Integrations in the app.
- Click Add Integration, and then select Talon One Loyalty.
- Enter your base URL in the Talon One base URL field, with no trailing slash.
- Enter your API key in the Talon One integration API key field.
- Click Connect.
- After you connect, toggle on the flow you want to use: Activate Talon One loyalty points on fulfillment.
Settings
- Activate Talon One loyalty points on fulfillment: Sends each new fulfillment to Talon One to activate the pending loyalty points on its order. When it’s off, the connector does nothing. Default: Off.
Flows
| Flow | Direction | Notes |
|---|---|---|
| Loyalty point activation | Pipe17 → Talon One | Runs every 5 minutes for new fulfillments. Points earned for an item activate when the fulfillment that contains that item ships. Points earned for the whole order activate only when all items on the order have shipped. Canceled fulfillments don’t count toward a fully shipped order. Points are sent to Talon One in groups of up to 50 per loyalty program. Points that are already active are skipped. Orders without Talon One loyalty details are skipped. |
| Activate points by order number | Pipe17 → Talon One | An on-demand action. Run Activate Talon One points by order number from the integration’s actions, and enter the order numbers in Order numbers (extOrderId). To send fulfillments that were already processed, turn on Re-process fulfillments already acknowledged by this integration. Talon One still skips points that are already active. |
| Orders | Not synced | The connector reads orders in the app only to find their loyalty details. It doesn’t send orders to Talon One or change them. |
Troubleshooting
-
The connection fails, or a fulfillment has an exception that says Talon One auth failed
The base URL or API key is wrong, or the key can’t activate loyalty points. Check the base URL for your region, and ask your Talon One administrator for a key with loyalty activation access. Then update them in the connection settings. -
A fulfillment has an exception that says Talon One reports no pending points to activate
Talon One has no pending points for that fulfillment. The points might already be awarded, or they might never have reached Talon One. Check the customer’s loyalty balance in Talon One before you dismiss the exception. -
A fulfillment has an exception that says Talon One client error
Talon One rejected the request, for example because the loyalty details on the order are invalid. Review the details in the exception, fix the data in Talon One or on the order, and then run Activate Talon One points by order number for that order. -
Points weren’t activated after an order shipped
Check that Activate Talon One loyalty points on fulfillment is on and that the order has thetalon_one_session_effectscustom field. Order-level points activate only after every item on the order ships. Points for an item activate only if its line on the order matches the item’s position in the original cart. -
A fulfillment has an exception that says Talon One transient error
Talon One was unavailable or limited requests, even after retries. The connector tries again on its next run. If the exception stays, check Talon One’s status.
Need Help?
If you need additional assistance:
- Use Ask Pippen, our AI agent, located at the top of the platform page.
- Submit a support request with as much relevant detail as possible. Learn how to submit a request.
We’re here to help you succeed with your operations.
Comments
0 comments