While most users seamlessly integrate Stripe with FirstPromoter, encountering issues can happen from time to time. If you're facing challenges, this guide will assist you in troubleshooting.
If the referral is tracking correctly and you see it appearing as lead in FirstPromoter, but it doesn't turn into a customer in about 2 minutes after the sale, you can check the following just to make sure the integration is completed:
Accessing the Integration
Navigate to your profile in the upper-right corner and select "Settings".
Proceed to the "Integrations" tab.
Scroll down to the "Integrations with third-parties" section.
Select "Update" under Stripe to access the integration settings.
2. Checking Stripe Account Connection
Verify if the correct Stripe account is connected.
Compare the connected Account ID in FirstPromoter with the Account ID in Stripe, accessible through "Settings" > "Account details" > "Account ID".
3. Mode Configuration
Ensure that Stripe is configured correctly based on the transaction mode:
If using Live Mode, verify that both FirstPromoter and the sale are in Live Mode.
If using Test Mode for Stripe, ensure that the integration reflects this setting.
In Test Mode, the integration screen should display appropriate indicators.
4. Switching Between Live and Test/Sandbox Mode
If you switch the mode in Stripe (from Live to Test/Sandbox, or from Test/Sandbox to Live), disconnect the Stripe integration in FirstPromoter and connect it again.
Reconnecting ensures that FirstPromoter stores the credentials and the account ID for the mode you are currently working in.
After reconnecting, confirm that the integration screen reflects the expected mode. In Test Mode you should see the "Test mode - Only test transactions are tracked" indicator, and the connected Account ID should match the one shown in Stripe.
Without reconnecting, sales made in the new mode may not be tracked at all, even though the referral is still visible as a lead in FirstPromoter.
5. Matching Leads
Confirm that the lead details match between Stripe and FirstPromoter:
Check if the customer email in Stripe matches the referral email in FirstPromoter.
If pre-filling the "uid" on the referral tracking script or API, verify if it matches the Stripe customer ID or the "fp_uid" value on Stripe customer metadata.
6. Payment Verification
Ensure that an actual payment has occurred, and it's not a future invoice.
Verify that the amount paid is greater than $0.5. Transactions involving 100% coupons or empty invoices won't track.
7. Coupon Code Tracking
If utilizing Coupon code tracking, ensure consistency between the invoice's coupon code and the one set on the promotion.
The "Coupon Code" field should contain the Coupon ID, not a promotion code. Each promoter should have a unique coupon, and reusing the same coupon ID for multiple promoters is not advisable.
8. "Track invoices only" Setting
This toggle is available in the Stripe integration settings, and it is disabled by default.
Turn it on if one sale is creating two commissions instead of one.
When it's on, FirstPromoter only tracks payments that come with a Stripe invoice. Subscriptions always create an invoice, one-time payments might not.
Leave it off if you sell one-time products, or if you're not sure. With it on, those sales won't be tracked at all.
If subscriptions track fine but one-time payments don't show up, check this toggle first.
By following these steps and verifying each aspect of the integration, you can effectively troubleshoot any issues encountered during the Stripe integration process with FirstPromoter.