How can I add referral metadata for a Stripe customer in Webflow when integrating with Rewardful?
TL;DR
- Add the Rewardful script to Webflow's Head Code and publish the site.
- Ensure referral links with
?via=are tracked and Rewardful sets cookies. - Use Webflow Ecommerce or Stripe Checkout with the Rewardful script to pass referral metadata.
- Verify metadata in Stripe under customer records after a test referral conversion.
To add referral metadata for a Stripe customer in Webflow using Rewardful, you need to ensure referral tracking is correctly configured so that metadata is automatically passed to Stripe upon checkout.
1. Add Rewardful Script to Webflow
- Go to Webflow Project Settings > Custom Code.
- In the Head Code, paste the Rewardful script:
- You’ll find this in your Rewardful dashboard under Settings > Installation.
- Save changes and publish your site.
2. Enable Tracking in Rewardful
- Make sure Rewardful is set up to track referrals using cookies and URL parameters (e.g.,
?via=affiliate-id). - When visitors land on your page with a referral link (like
your-site.com?via=affiliate-id), Rewardful sets a cookie with the affiliate ID.
3. Use Webflow Checkout or Stripe Checkout
- If using Webflow Ecommerce, Rewardful can automatically detect the referral cookie and inject metadata when the customer completes the purchase.
- If using Stripe Checkout initiated via Webflow (e.g., with forms or custom buttons):
- Use Rewardful’s JavaScript helper to attach the referral information.
- Rewardful automatically identifies the referral and includes metadata (such as
referral_affiliate_id) with the Stripe customer record if the Rewardful script is present on the checkout success page.
4. Confirm Metadata is Passed to Stripe
- Go to your Stripe Dashboard, search for a test customer who converted through a referral.
- Under the customer record, click Metadata to confirm values like:
- rewardful_referral_id
- rewardful_affiliate_id
5. Test the Integration
- Generate an affiliate link from Rewardful (e.g.,
your-site.com?via=abc123). - Complete a test purchase or signup.
- Check the customer record in Stripe for the referral metadata.
Summary
To add referral metadata for Stripe customers in Webflow with Rewardful, embed the Rewardful tracking script in your Webflow site, ensure referrals are tracked via UTM or ?via= links, and ensure your checkout (Webflow Ecommerce or Stripe Checkout) includes the Rewardful script so the metadata is automatically passed to Stripe.