Skip to main content

Rewardful Integration

Grow your audience with a powerful affiliate program that integrates with Stripe

Updated this week

Rewardful is a powerful affiliate marketing platform that integrates with Uscreen to help you set up and manage affiliate and referral programs.

This integration works exclusively with Stripe payments and automatically handles commission adjustments for various scenarios like upgrades, downgrades, free trials, cancellations, and refunds.


Set Up Rewardful with Uscreen

Step 1: Connect Your Stripe Account in Rewardful

In Rewardful

  1. Connect your Stripe account to Rewardful

  2. Create your affiliate campaign in Rewardful

Step 2: Get Your Rewardful API Key

In Rewardful

Option 1: Platform Integration

  1. Click your profile at the top-right

  2. Select Setup Instructions

  3. Click the tab Add Rewardful to your website

  4. Select Uscreen under the tab No-code platform integrations

  5. Copy your Rewardful API key and save it in a text editor

Option 2: Company Settings

  1. Click your profile at the top-right

  2. Select Company Settings

  3. Scroll down to the API credentials section

  4. Copy your Rewardful API key and save it in a text editor

Step 3: Connect Rewardful to Uscreen

In Uscreen

  1. Navigate to Settings > Integrations

  2. Find Rewardful and click Connect

  3. Paste your Rewardful API key in the field provided

  4. Click Connect to finalize the integration

Step 4: Verify the Connection

  1. Return to Rewardful and click Setup Complete

  2. Confirm the installation

  3. A new tab may open, and you can simply close that tab

  4. Refresh the Rewardful page to see the confirmation message

📝 NOTE: You'll only see profit sharing occur when a charge has been successfully made. Free trials will not show any successful referrals until they become paying customers.


How Rewardful Works with Uscreen

When integrated with Uscreen, Rewardful:

  1. Captures referral codes during checkout from URLs

    • Example: yourdomain.com/?via=yourreferralcode

  2. Sends data to Stripe, including payment information and Uscreen User ID

  3. Automatically handles commission adjustments for various scenarios

  4. Provides each affiliate with a personalized dashboard to track their success

ℹ️ INFO: Each person who signs up for your program will have access to their own dashboard in Rewardful, where they can create and manage their affiliate links and monitor their performance.


Technical Details: Data Sent to Rewardful

The information sent to Rewardful includes:

stripe_id, { metadata: { referral: referral_code } }

ℹ️ INFO: This data allows Rewardful to properly track and attribute sales to your affiliates.


Using Coupons with Rewardful

⚠️ WARNING: Uscreen does not currently support integrating Rewardful's coupon code feature. This means that while Rewardful offers the ability to create, share, and track coupon codes for affiliate marketing, this specific functionality cannot be utilized in conjunction with Uscreen.

Workaround: Combining Uscreen Coupons with Affiliate Links

You can create a workaround by:

  1. Creating coupons directly in Uscreen

  2. Having affiliates share a URL that includes both

    • their affiliate code parameters: via=affiliatecode

    • the Uscreen coupon code: d=COUPONCODE

Example URL format

https://yourdomain.com/?via=affiliatecode&d=COUPONCODE

This allows affiliates to offer discounts while still getting credit for the referral.

📝 NOTE: While the workaround allows your affiliates to provide a discount using coupon codes to their referrals, these codes are not tracked by Rewardful. You may track the referral count through Rewardful and separately track the coupon code usage through the Coupons Report in Uscreen.

🔗 Learn more about Coupons Report


FAQs

How is the conversion data sent to Rewardful?

Uscreen captures the referral code during checkout from URLs with the format yourdomain.com/?via=yourreferralcode. This data is then set on the user object in Stripe and sent to Rewardful. The data includes payment information and the User ID in Uscreen.

Rewardful is not working. How can I troubleshoot this?

Try these troubleshooting steps:

  1. Ensure you've added your Rewardful API key to your Uscreen site

  2. Clear your browser cache and retry confirming the installation, or try following the confirmation link in an incognito window

  3. Check the URL you entered in your Campaign Settings and ensure it's part of your Uscreen site

  4. If you removed the footer tag in your theme files, add {{footer_uscreen}} back to your theme footer

  5. Disable any ad blockers, as they can interfere with Rewardful scripts

Does Rewardful track Gross vs Net price?

Rewardful calculates referral commissions based on the 'net' price. If a coupon is used during checkout, Rewardful will calculate the commission using the discounted price.

Can I use Rewardful with PayPal payments?

No, Rewardful only integrates with Stripe. If you have PayPal set up in addition to Stripe, referrals made where the purchase is done via PayPal cannot be linked back to Rewardful.

Will Rewardful track mobile app purchases?

No, Rewardful only tracks web-based purchases. In-app purchases through app stores are not tracked through the Rewardful integration.

Did this answer your question?