Affiliate Documentation
Affiliate Program Overview

MailerRocket Affiliate & Postback Integration Guide

In MailerRocket, every customer automatically becomes an affiliate. You can also sign up and log in as a standalone affiliate account. This guide explains how referral links work, how clicks and conversions are tracked, how to set up server-to-server (S2S) postbacks, and how to request withdrawals.

Audience: affiliates, tracking platforms, partners Covers: referrals · clicks · earnings · postback

Getting started as an affiliate Account & access

There are two ways you can become an affiliate in MailerRocket:

1. Existing customer (auto–affiliate)

If you already purchased a MailerRocket plan, your customer profile is automatically linked to an affiliate account. Use the same login credentials to access the affiliate dashboard.

  • Go to the customer portal URL.
  • Log in with your existing email and password.
  • Open the menu Affiliates → Dashboard.
  • Click here to login as customer
No extra signup Single sign-on

2. Standalone affiliate login

If your account is configured as a pure affiliate (without an active plan), simply:

  • Visit the public affiliate login / registration URL.
  • Create an account or sign in.
  • You'll land directly on your Affiliate Dashboard.
  • Click here to login as affiliate
Independent affiliate Can promote without a plan

Referral links and referral codes How to promote

The affiliate dashboard provides both a referral link and a referral code. Any customer that signs up through your link or code is attributed to you, and any qualifying purchase generates commission.

Your referral link

This is the easiest way to promote MailerRocket. You can share it anywhere: your blog, email, social media, or ad campaigns.

Example referral URL
  • Automatic attribution based on referral ID.
  • Works for first-time customers.
  • Safe to use in ads and landing pages.

Your referral code

In some funnels, customers can manually enter a referral code during checkout or signup. That code is tied to your affiliate account.

Example referral code
AF12345
  • Ideal for webinars or live events.
  • Can be read aloud or printed on slides.
  • Works alongside referral links.

Click logs & reporting Analytics

The Click Logs section in the affiliate area lets you inspect individual clicks and high-level charts. Click data is used to compute your conversions and commissions.

Clicks vs Conversions

On the affiliate dashboard you see a chart of Clicks vs Conversions for the last 30 days. This helps you evaluate your funnel performance.

  • Total clicks and unique clicks.
  • Successful purchases attributed to you.
  • Conversion rate trends over time.

Click log list

The click log table includes detailed rows per click event. It is primarily informational and may be filtered by date range.

  • Click timestamp and source.
  • Device/geo information (when available).
  • Mapped to affiliate and optional external click ID.

Earnings, balances & withdrawals Payouts

All eligible commissions are recorded as earnings in your affiliate account. Depending on your configuration, commissions may be subject to holding periods or minimum payout thresholds.

Earnings dashboard

The earnings section shows your available balance, pending commissions, and historical payouts.

  • Available balance – eligible for withdrawal.
  • Pending – within refund/chargeback window.
  • Lifetime – all approved commissions to date.

Withdrawals

When your balance meets the minimum payout amount, you can submit a withdrawal request. Payment methods depend on your account configuration (e.g. bank transfer, PayPal, etc.).

  • Navigate to Affiliates → Withdrawals.
  • Choose your payout method and amount.
  • Submit the request and track its status.

Postback URL / S2S tracking Advanced integration

MailerRocket supports server-to-server (S2S) postback URLs so you can track conversions inside external networks, trackers, or analytics platforms. Postbacks are triggered when a purchase is confirmed for a referral.

1. Configure your callback URL

Go to Affiliates → Postback in your dashboard. You can paste a full callback URL (including query string), or start with a clean base URL and add parameters using the UI.

  1. Paste your tracking platform postback URL in the Full callback URL box.
  2. Click Parse / Manage callback link to auto–detect query parameters.
  3. MailerRocket splits it into a base URL and a list of parameters.
Example postback URL
https://yourtracking.com/postback?event=sale&click_id={click_id}&payout={payout}&name={customer_name}&email={customer_email}&plan_name={plan_name}&plan_price={plan_price}&purchase_date={purchase_date}&purchase_id={purchase_id}

2. Macro parameters

For each supported field you can choose the parameter key your tracking platform expects. Common internal macros are listed below:

  • {customer_name} – full name of the buyer.
  • {customer_email} – buyer email.
  • {plan_name} – purchased plan title.
  • {plan_price} – price paid by the customer.
  • {payout} – your affiliate commission.
  • {purchase_date} – time of purchase.
  • {purchase_id} – internal transaction ID.

In the UI, tick the checkbox for each macro you want to send, and enter the external parameter name (e.g. amount, sub1, uid, etc.).

3. Custom parameters

You can also define up to 20 custom key/value pairs that are appended to every postback. These values are fixed strings (not macros).

  • Good for static tags or integration flags.
  • Example: source = mailerrocket.
  • Example: event = sale.

Custom keys and values are limited to 100 characters each.

4. Verify and save

Before your postback configuration is saved, MailerRocket will verify the callback URL structure:

  • The system builds the full postback URL from your base + parameters.
  • We send a test request and expect an HTTP 2xx response.
  • If verification fails, the URL is not saved and an error is displayed.

Once saved, each qualifying purchase will create a Postback Log entry and the system will attempt to send your callback. Logs are visible on the affiliate side and retried by background jobs when necessary.

Testing & troubleshooting Quality checks

Use this checklist when your tracking platform doesn’t show expected conversions.

Checklist

  • Confirm you are using the correct referral link.
  • Make a test purchase using a private / incognito browser.
  • Check the Click Logs to ensure the click was recorded.
  • Verify that a Postback Log entry exists and has an HTTP 2xx status.
  • If your tracker expects a click_id, be sure it is passed along and echoed back.

Understanding postback logs

Each postback attempt creates a log entry with the final URL, HTTP status, and retry count.

  • Pending – queued to be sent by the background worker.
  • Success – remote server returned HTTP 2xx.
  • Failed – non-2xx response or network error; may be retried manually.

Frequently asked questions FAQ

Do I need to buy a plan to become an affiliate?
No. Existing customers are automatically affiliates, but you can also register as a pure affiliate and promote MailerRocket without purchasing a plan.
Where do I find my referral link?
After logging in, go to Affiliates → Dashboard. Your primary referral link and referral code are displayed at the top of the page. You can copy and share them anywhere.
When are commissions approved and withdrawable?
Commissions typically enter a pending state for a configurable holding period, to cover refunds or chargebacks. Once cleared, they appear as available balance and can be withdrawn using the withdrawal page.
Can I resend a failed postback?
Yes. If a postback log entry is marked as failed, you can trigger a retry from the affiliate interface (when available) or contact support. The backend command will re-ping the stored URL.
What response should my tracking platform return?
Any HTTP 2xx response (for example 200 OK) is treated as success. Non-2xx responses are considered failures and may be retried depending on configuration.