Skip to main content

Email integration: Sending invoice emails

Forwarding invoice emails to ReferralCandy

Adam avatar
Written by Adam
Updated this week

Forwarding or BCCing your invoice emails to ReferralCandy is required for the email integration to work. The emails sent to ReferralCandy are scanned to detect referrals, identify referral details, and track purchases at your store.

Note: This is one of two steps required to complete email integration. The next step is Add a referral tracking code.

ReferralCandy needs to receive your invoice emails for the following reasons:

  • Track referrals. ReferralCandy must collect all purchase data via the invoice emails to identify which transactions are referrals.

  • Detect fraudulent referrals. The system ensures that referrals are legitimate, and only new customers are marked as referrals, preventing existing customers from making referred purchases.

  • Send post-purchase invites. If enabled, customers immediately receive the invite email, encouraging them to join your referral program.

After ReferralCandy receives and processes the invoice emails, the customer is added to your campaign as a contact, and if they meet your segment criteria, they're enrolled in your referral campaign.


Forwarding invoice emails

For email integration to work, you must forward all your invoice emails to ReferralCandy. The system scans the received invoice emails to identify which purchases come from referrals.

Invoices are sent to your unique ReferralCandy email address found on the Integrations > Standalone page of the dashboard.

Required information

Below are the invoice details necessary for email integration to detect and track referred purchases. The invoice emails you forward to ReferralCandy should contain the following, in no particular order:

  1. First name of the customer

  2. Last name of the customer

  3. Email address of the customer. This should be in the email body or the "To" field.

  4. Total invoice amount and the 3-letter currency code

  5. Subtotal amount and the 3-letter currency code

    • The system uses this amount to calculate cash rewards and success fees. See Subtotal amount below to learn more.

  6. Time, including minutes and seconds, when the customer views the purchase completed or "Thank you" page where the referral tracking code was inserted.

    • This is optional if you're sending invoice emails to ReferralCandy immediately when the customer views the purchase completed page

  7. Preferred language of the customer

  8. (Optional) Whether the customer consented to marketing. If you want to enroll only customers who opt in to receiving marketing emails, this lets the system know. For example, "Marketing consent: false" or "Marketing consent: true."

These information will displayed on the Invoice History page of your ReferralCandy dashboard.

Subtotal amount

The subtotal is the amount the system uses to calculate percentage-based cash rewards and success fees charged along with your ReferralCandy subscription. The subtotal is typically the amount after any discounts are applied, but before taxes and shipping fees. Learn more

How the invoice email is parsed

The system reviews 1 to 3 samples of your invoice emails to analyze and extract required information, including the total and subtotal amounts. If your invoice emails are inconsistent, specific details may be missed during processing, which may affect referral tracking and the charges made to your account.

Ensuring correct invoice processing

To prevent miscalculations of your rewards and commission fees:

  • Your invoice emails should use a consistent template and terminology for the system to accurately process the subtotal amount

  • Avoid lines of information that disappear when not applicable to the invoice, especially if it's an amount necessary to calculate ReferralCandy charges and fees. If possible, keep the amount in the email even if it's zero.

  • Use simple terms so the invoice details are clear to the system

  • Avoid duplicating, misspelling, or using confusing terms that may cause issues with invoice processing

Note: If you want a specific amount extracted from your invoice template to calculate rewards and fees, contact us so the ReferralCandy team can assist you with your email integration setup.



πŸ’¬ Need help? Click the chat widget on the right to start a conversation. Learn more


Did this answer your question?