Sprusify
Get started

Troubleshooting & FAQ

Use this page to diagnose the most common setup, attribution, and payout issues.

Issue: Clicks Are Tracked but No Conversions

Check:

  • Referral parameters are present on landing pages.
  • Attribution window has not expired.
  • Webhooks are delivering successfully.

Try:

  1. Place a fresh test order from an incognito session.
  2. Verify coupon mapping if coupon attribution is enabled.
  3. Run order reconciliation for the affected date range.
  4. Confirm the Affiliate Tracking app embed is enabled in Theme Customizer using advanced-integrations/affiliate-tracking-app-embed.

Issue: Commission Amount Looks Incorrect

Check:

  • Campaign precedence and override rules.
  • Product or collection exclusions.
  • Pre-discount versus post-discount commission setting.

Try:

  1. Open the order attribution detail.
  2. Compare applied rule with campaign configuration.
  3. Recalculate the order after correcting rule setup.

Issue: Payout Is Delayed or Failed

Check:

  • Affiliate has met payout threshold.
  • Account is in approved payout state.
  • Payout provider account has no verification hold.

Try:

  1. Review payout attempt logs.
  2. Confirm payout destination details are valid.
  3. Retry payout after resolving provider issues.

Issue: Affiliate Login Problems

Check:

  • Invite or magic-link email was delivered.
  • Link has not expired.
  • Affiliate profile email matches login email.

Try:

  1. Resend invitation or sign-in link.
  2. Test mail deliverability and sender settings.
  3. Ask affiliate to check spam and filtered folders.

Issue: Webhook Delivery Failures

Check:

  • Endpoint responds quickly with HTTP 200.
  • Signature verification secret is correct.
  • TLS certificate and firewall settings allow delivery.

Try:

  1. Replay failed webhook events.
  2. Verify idempotency behavior with duplicate payloads.
  3. Add alerting for repeated delivery failures.

If the tracking script never loads on storefront pages, start with advanced-integrations/affiliate-tracking-app-embed.

FAQ

Q: How long does attribution last? A: Attribution windows are configurable per campaign and commonly range from 7 to 30 days.

Q: Can commissions be adjusted after an order? A: Yes. Manual credits and reversals can be applied through dispute and adjustment workflows.

Q: Can I use links and coupons together? A: Yes. Many programs use both to improve cross-device attribution coverage.

If issues continue, include order ID, affiliate ID, timestamp, and screenshots when contacting support.