MDH GROUP · BLOG

Onboarding Playbook for Merchants: How to Launch Your Partner Program with Affilentra (self-hosted)

Setting up a partner program is more than setting commissions: products, creatives, tracking and billing must fit together. With a self-hosted solution like Affilentra, merchants keep control over data, terms and operation — but need a clear onboarding process.

← All posts

Onboarding Playbook for Merchants: How to Launch Your Partner Program with Affilentra (self-hosted)

Introduction

Setting up a partner program is more than setting commissions: products, creatives, tracking and billing must fit together cleanly. With a self-hosted solution like Affilentra, merchants retain control over data, terms and operation — but need a clear onboarding approach. This step-by-step checklist guides merchants through the most important setup stations: product creation, creatives, commission logic, tracking verification and test orders. In the end there is a market-ready, transparent partner program.

Preparation: Clarify roles, goals and resources

Before you start technically, define three points:

  • Role in the system: Who is the software operator (hosting, maintenance), who is the merchant (product owner) and who are the partners? In self-hosted installations merchants remain in the merchant role with access to their program.
  • Onboarding goals: Which products should be promoted, which target KPI (e.g. number of sales, CAC limit) apply? Concrete goals help with commission design.
  • Resources: Responsible persons for product data, creatives, IT integration (tracking) and accounting for payouts.

Step 1 – Product creation: clear, complete, linkable

Goal: Each product must be created in the system uniquely, completely and partner-ready.

  • Create product master: SKU, title, short description, product category, relevant price (net price/gross price) and, if applicable, variant data (sizes, colors).
  • Product URLs: Add landing pages and order pages. Make sure to use clean, permanent URLs without session IDs.
  • Visibility for partners: Set product status (active/inactive) and define approval criteria, e.g. whether partners must apply in advance.
  • Additional information: Return conditions, minimum order value for commission eligibility and seasonal durations for promotions.

Step 2 – Creatives and provisioning

Goal: Partners need immediately usable, documented creatives and tracking links.

  • Create a creative set: Banners (various formats), text blocks for social/newsletters, product feeds and example texts with legally required information.
  • Download and preview function: Ensure that affiliates can download creatives directly and view them in their accounts.
  • Generate tracking links: Provide standard links and example affiliate URLs. Explain how partners create their own links and which parameters are important (e.g. affiliate_id, campaign).
  • Rules for creatives: Record usage rights, branding guidelines and permitted landing pages.

Step 3 – Commission setup: transparent and traceable

Goal: Define how, when and under which conditions commissions are generated and paid out.

  • Choose commission models: Fixed amount or percentage share. Also define tiers, bonus levels or lifetime commission rules if desired.
  • Validity rules: Cookie/attribution window, exclusion criteria (e.g., voucher combinations), minimum order value and cancellation review periods for return checks.
  • Billing periods: Payment interval (monthly/quarterly), minimum payout amount and documentation requirements for partners (tax ID, bank details).
  • Automatic vs. manual approvals: Decide which processes are calculated automatically and which transactions should be reviewed manually (e.g., high ticket values).

Step 4 – Tracking & Verification: technical safeguards

Goal: Ensure that conversions are correctly recorded, validated and linked to partners.

  • Configure tracking methods: Use server-to-server (postback) and/or client-side tracking (JavaScript pixel), depending on shop architecture. Affilentra supports multiple tracking paths; set the primary method for your setup.
  • Parameter mapping: Align order ID, total amount, currency and partner ID between shop and Affilentra. Consistent field names prevent mapping errors.
  • Validation rules: Define criteria for valid conversions (e.g., payment status 'paid', no cancellation within X days). Implement checks for duplicate order IDs and manipulated parameters.
  • Logging & monitoring: Enable transaction logs in Affilentra and set up alerts for failed postbacks or high cancellation rates.

Step 5 – Test orders: realistic and reproducible

Goal: Test the tracking across the entire path — from partner link to payout entry.

  • Create a test partner account: Create a partner profile and generate a tracking link for a test product.
  • Cookie and session check: Open the tracking link in a fresh browser or an incognito window. Check whether tracking cookies are set and what their duration is.
  • Perform a test order: Complete the purchase on the shop page. Note the order ID, amount, and payment method used.
  • Postback/pixel verification: Check whether the conversion appears in Affilentra, whether parameters were transmitted correctly, and whether the commission was calculated automatically.
  • Cancellation/return simulation: Simulate a return or cancellation to verify whether the commission is cancelled or reversed.
  • Test billing run: Perform a demo billing run (e.g., test month) to check statement and payout entries.

Step 6 – Go-Live Checklist and Communication

Before the official launch, check the following points:

  • All products are set up correctly and visible to partners.
  • Creatives are available and legally reviewed.
  • Commission rules and billing intervals are documented.
  • Tracking is technically verified and test orders successful.
  • Internal responsibilities for support, fraud monitoring and billing are defined.

Communicate to partners: start date, available creatives, registration process and support contact. Provide a short onboarding document or webinar so that new affiliates can get started without questions.

After the Launch: Monitoring, Optimization, Scaling

A partner program is an ongoing product. Focus on:

  • Monitoring: Continuously check conversion rate per partner, cancellation rates and technical errors.
  • Optimization: Highlight high-performing creatives, reactivate inactive partnerships, adjust commission incentives as needed.
  • Scaling: After a successful test run, enable additional products, integrate networks (e.g., publisher pools), and, if necessary, migrate from PRO to NETWORK Edition if you want to manage multiple merchants or tenants.

Practical Checklist (Short Version)

  • Define roles and goals
  • Enter product data completely into the system
  • Provide creatives and tracking links
  • Document commission models and billing rules
  • Configure tracking technically and match parameters
  • Create test partners and perform test orders
  • Test cancellation and billing runs
  • Plan communication to partners before the go-live

Why Affilentra as a self-hosted solution?

Affilentra combines the advantages of a full partner sales platform with the control of a self-hosted installation. Merchants retain authority over product data, terms and payout processes. The clearly separated roles (software operator, Merchant, Partner) simplify compliance and reporting. Affilentra offers functionality for tracking, commission calculation and settlement in a platform that you can run on your own infrastructure – as a perpetual license without revenue sharing (PRO & NETWORK editions).

Conclusion and next step

A structured onboarding minimizes friction and technical errors when launching your partner program. Follow the checklist: product setup, marketing assets, commission setup, tracking verification and test orders are the critical milestones. If you want to use Affilentra self-hosted, choose the appropriate entry point and start with a controlled test run before you scale.

Choose a starting point

Next step

Try Affilentra yourself

Unified platform that transparently brings together product provisioning, tracking, conversion validation, commission calculation and payout across clearly separated roles; option for a self-hosted installation with a perpetual license without revenue sharing; Merchants retain control over products, terms and marketing materials; Partners receive personal tracking links and a traceable payout history.

Choose a starting point