Voluum + MassPartner: Send Affiliate Conversions to Voluum

To integrate Voluum with MassPartner, add MassPartner as an affiliate network in Voluum, append sub1={clickid} to your MassPartner tracking link in the Voluum offer, and create a MassPartner callback that calls your Voluum postback URL with cid={$sub1} and payout={$commission}. Every approved conversion then lands in Voluum on the original click, with your commission as revenue.

This guide is for media buyers who run paid traffic through Voluum and promote brands from MassPartner, which is free to join for affiliates. If server-to-server tracking is new to you, read what a postback URL is first. The same setup for other trackers is covered in RedTrack, Keitaro and Binom.

How the Voluum integration works#

Voluum and MassPartner each issue their own click ID. Voluum's ID matters, because your costs live there. You pass it to MassPartner in the sub1 sub ID, MassPartner stores it with the click and the conversion, and the callback returns it with {$sub1}.

MassPartner's own click ID, {$clickid}, means nothing to Voluum. Never map it to cid.

Set up the Voluum integration in four steps#

Step 1: Add MassPartner as an affiliate network in Voluum#

1. In Voluum, open the Affiliate networks tab, click Create, choose Affiliate network and start from Other affiliate network.
2. Name it "MassPartner".
3. In the Parameters section, set Click ID parameter to sub1, Click ID placeholder to {$sub1} and Payout placeholder to {$commission}. Voluum uses the placeholders to build the postback URL.
4. Set Method to "S2S postback URL" and Currency to the currency your MassPartner commissions are paid in.
5. Leave Accept duplicate postbacks off. You will send a unique transaction ID instead.
6. Save, open the Tracking tab and copy the postback URL.

These fields are described in Voluum's guide to adding an affiliate network. The optional Append click ID to offer URLs toggle adds {clickid} automatically, but only if each offer URL ends with sub1=.

Step 2: Build the offer URL with Voluum's click ID in sub1#

Create an offer in Voluum under the MassPartner network. Copy your tracking link from the MassPartner dashboard. It already contains a query string, so add the click ID with &:

YOUR_MASSPARTNER_TRACKING_LINK&sub1={clickid}

{clickid} is the Voluum tracking macro that passes its click ID to an affiliate network (Voluum S2S guide). MassPartner keeps sub values up to 255 characters and shows them in your click and conversion reports. Keep sub1 for the click ID on every offer and use sub2 to sub5 for your own labels, as explained in our guide to sub ID tracking.

Step 3: Create the MassPartner callback with your Voluum postback URL#

In the MassPartner dashboard, open Callbacks, click Add callback, choose GET and paste the URL from Voluum's Tracking tab, completed like this:

https://your-voluum-domain.com/postback?cid={$sub1}&payout={$commission}&currency={$currency}&txid={$conversionid}

Tick Conversion approved. cid is required. payout takes your commission, not {$saleamount}. currency overrides the offer's currency, and txid passes a unique transaction ID, which Voluum uses to record secondary conversions such as upsells (Voluum postback parameters). With {$conversionid} as txid, each recurring RevShare sale counts once. All placeholders are listed in the callback docs.

Voluum's postback has no status field. To see other stages, send a conversion type in et and define it under Settings > Custom conversions. Create one MassPartner callback per row:

For each custom conversion, untick Include in "Revenue" column so only approved commissions count as revenue. Parameter values are case-sensitive, and you can define up to 20 custom conversions (Voluum custom conversions). Voluum's docs don't describe reversing an earlier conversion by postback, so a rejection or refund appears as its own conversion type next to the approved one, which is a useful signal for spotting a commission reversal early.

Step 4: Test with Send test and a real click#

1. Click Send test next to the callback. MassPartner sends sample values (test_sub1 as the sub ID, a 10.00 USD commission) and shows the delivery result, HTTP code and exact URL. Voluum can't credit test_sub1, but the result proves the URL is reachable and the placeholders are filled.
2. Open your Voluum campaign URL once. In MassPartner's click report, confirm the Voluum click ID sits in sub1, untruncated.
3. Complete a real conversion, or ask the brand to approve a test one, and check that Voluum shows it with the right payout.

Parameter mapping#

Troubleshooting#

Check Voluum's Error log and the MassPartner callback list, which shows each callback's failures and last error.

Track MassPartner offers in Voluum#

Find a program in the affiliate programs directory and add the callback once: it covers every brand you promote. Our guide to sending affiliate postbacks to a tracker compares Voluum with other trackers.