How to setup flow reward journey?

Before you start

1. Setting up the Flow reward experience requires using the Loop Storefront APIs here.
2. Ensure that the Flow reward journey is configured and active in the Loop admin portal before implementing the storefront logic.

Pre-requisites

• Configure Flow reward journeys in Loop admin.
• Ensure the reward configuration is active.
• On the storefront, you only need to fetch and render the banner (no reward logic is required on the frontend).
• Keep the subscriptionId ready to fetch banner details.

Flow reward storefront API endpoint

This endpoint returns the Flow reward banner details applicable for a subscription.

• Endpoint (GET):
  • https://api.loopsubscriptions.com/storefront/2023-10/subscription/\{subscriptionId}/flowRewardBanner
• Path Params:
  • subscriptionId: The unique identifier for a subscription in Loop.

Endpoint payload (what it returns)

The response contains the banner information required to render the Flow reward experience.

• text: Customer-facing banner text. This can include formatted or localized content and should be rendered directly in the UI.
• isRewardReceived: Indicates whether the reward has already been applied to the subscription.

Implementation notes

• Render the banner text in the customer portal when data is returned.
• Use isRewardReceived to:
  • Show confirmation state (e.g., reward already applied), or
  • Control conditional UI states if needed.
• No additional action (like claim APIs) is required for Flow rewards — the reward is already applied via backend logic.