Move your program from Tolt

Bring your affiliates, their referral codes, their customers and their commissions from Tolt to Anderro, step by step.

What this guide covers

You run an affiliate program on Tolt and want to run it on Anderro instead. This guide takes you from your first step to the day you close the Tolt program. You do not need a developer for the import itself. You may need one for the last part, where the tracking code on your website is swapped.

The import brings over:

  • your affiliates (Tolt calls them partners)
  • the referral codes in the links they already share
  • the customers they referred
  • their commissions, if you choose to bring them

Nothing is changed on Tolt. The import only reads from it.

You do everything on one page. In the Anderro dashboard, open your product and then the Import tab. The address looks like https://anderro.com/business/<account>/saas/<product id>/import. Only the account owner and admins see this tab.

Before you start

  1. Create the product on Anderro. The import needs a product to import into.
  2. Set the product's terms to what your affiliates were promised on Tolt. Open the product's Settings tab and set:
    • the commission rate
    • whether commission is recurring (paid on every payment from a customer) or one-time (paid on the first payment only)
    • first-click or last-click attribution. Attribution decides which affiliate gets the sale when a customer clicked more than one affiliate's link: the first one or the latest one.
    • the payout frequency
    • the minimum payout

The import does not copy these terms from Tolt. Imported affiliates see the Anderro terms, so set them before you import.

How the import works

The import has two stages:

  1. Preview. Anderro reads your Tolt program and shows what an import would do. Nothing is saved.
  2. Import. You press a button and the records are created on Anderro.

You can run the import more than once, and you can undo it. Both are explained below.

1. Create a Tolt API key

An API key is a password that lets one service read data from another. Anderro uses it to read your program from Tolt.

  1. In Tolt, open Settings → API keys.
  2. Press Create API key.
  3. Give it a name that says what it is for, such as "Anderro import".
  4. Copy the key. Tolt shows the full key once.

Create a key just for this move

Tolt keys can also write to your Tolt account, not only read. Do not reuse a key that something else depends on. Create one for the move and delete (Revoke) it in Tolt when you are done.

2. Paste the key and preview

  1. In Anderro, open your product and then the Import tab.
  2. Paste the key into Tolt API key.
  3. Press Preview the import.

Anderro now reads your program from Tolt. This can take a few minutes for a large program. You can leave the page. It keeps going.

When it finishes you see Review before importing. Nothing has been imported at this point. The preview shows exactly what will happen when you press Import:

Line in the previewWhat it means
New affiliatesAffiliates the import will add to your program.
Keeping their referral codeAffiliates whose main code on Anderro is the same as on Tolt.
Getting a new main code (old links still work)Affiliates whose Tolt code could not be used as their main code. See Referral codes.
Referred customers carried overCustomers who will be linked to their affiliate on Anderro.
Customers who are their own affiliateCustomers with the same email as the affiliate who referred them.
Commissions importedCommissions that will be recorded, depending on your choice in step 3.

Below the totals there are two lists you can open:

  • Skipped: records that will not be imported, with the reason for each one.
  • Imported, with a note: records that will be imported, with something you should know about each one.

Read both lists before you continue.

How your key is handled

  • The key is sent to Anderro over HTTPS, an encrypted connection.
  • It is stored encrypted.
  • It is never shown again. The page only shows its last four characters, for example "Key ending …abcd".
  • Only the import job uses it, and that job only reads from Tolt.
  • It is deleted when you finish or cancel the import. If you do neither, it is deleted automatically after 7 days.

What is imported

Affiliates

  • Every active partner is imported.
  • Partners who are suspended or otherwise not active on Tolt are skipped. Their customers and commissions are skipped too.
  • If an affiliate's email already has an Anderro account, the affiliate is linked to that account.
  • Every other affiliate gets an account that they claim later by signing up on Anderro with the same email.

Referral codes

A referral code is the part of an affiliate's link that identifies them, such as jane in https://yourapp.com/?ref=jane.

  • Codes are kept when possible.
  • A code that is too short or otherwise not valid on Anderro, or that is already used by another program on Anderro, cannot be the affiliate's main code. That affiliate gets a new main code. The old code keeps working as an alias for your product, so existing links do not break. An alias is a second code that points to the same affiliate.

The ending is the name before the code in a link: ref in ?ref=jane. Anderro's own links end in ?ref=. Links your affiliates already shared may end differently, for example ?via=jane. In Review before importing, the question Which link endings should keep working? lets you choose which ones Anderro reads for your product:

Group on the pageWhat it is
Found in your Tolt programEndings your Tolt links use, with how many affiliates use each and one real link. These are ticked for you. Leave them ticked unless you want those links to stop counting.
Always on?ref=, and the endings only affiliate platforms use (?fpr=, ?fp_ref=, ?rfsn=, ?lmref=, ?a_aid=). They are read for every product and cannot be turned off.
Other common endings?via=, ?aff=, ?affiliate=, ?partner= and ?referral=. Off until you tick one.
Your ownAny other ending your links use. Type it and press Add.

Things to know:

  • If you change a tick, the button becomes Update the preview. The new preview tells you which old links will keep working and which will not.
  • You can have up to 8 endings besides the ones that are always on.
  • Some names are refused because they already mean something else on a link, such as utm_source, gclid or email.
  • The import only adds endings. It never turns off one that is already on for your product.
  • After the import, the page lists the endings Anderro now reads. You can change them at any time under the product's Settings, in Link endings that count as a referral. A change reaches your site within 5 minutes of saving, and the snippet on your site stays as it is.

Only turn on an ending your own campaigns do not use

A general name such as via is also common in ordinary campaign links (?via=newsletter). If you turn it on and an affiliate's code happens to be newsletter, that affiliate is credited for your campaign's visitors. Turn on an ending only when affiliate links are the only links that use it on your site.

If your server reports sign-ups itself with referralCode (see the Quickstart), the ending does not matter to Anderro: your site reads the code from whichever ending it likes.

Customers

  • Paying customers, cancelled customers and leads are carried over with their affiliate. A lead is someone who signed up through an affiliate's link and has not paid yet.
  • This means future payments from these customers are credited to the right affiliate.
  • A customer with the same email as their affiliate is imported with a note. Anderro does not pay commission on self-referrals.

Payout details

Tolt's API does not share payout details. Your affiliates add their PayPal or Wise details on Anderro before their first payout.

Currency

Commissions are imported in USD.

3. Make the three choices

The preview asks three questions.

Which affiliates?

  • Everyone: every active affiliate, so every link keeps working. Choose this unless you have a reason not to.
  • Only those who referred someone: leaves out affiliates with no customers and no commissions. Links of the affiliates you leave out stop being tracked after you switch over.

Tick every ending your affiliates' existing links use. The endings your Tolt links use are found and ticked for you, so in most cases you change nothing here. Link endings explains each group.

What about commissions?

  • Leave them out: only affiliates and customers are imported. You settle what is owed on Tolt.
  • Bring them as history: every commission is recorded as already paid. Nothing becomes payable on Anderro. Choose this if you want affiliates to see their past earnings and you pay the open balance on Tolt.
  • Keep unpaid ones payable on Anderro: unpaid commissions go into your next Anderro payout run. Commissions already paid on Tolt stay recorded as paid.

Do not pay the same commission twice

If you choose Keep unpaid ones payable on Anderro, you must tick the box confirming that you have stopped paying these commissions on Tolt. Otherwise affiliates are paid twice: once by Tolt and once by Anderro.

Refunded and rejected commissions are never imported.

After you change a choice, press Update the preview and read the new totals.

4. Import

Press Import.

  • The affiliates become active in your program straight away.
  • Anderro does not email them during the import. You decide when they hear about the move. See Tell your affiliates.

5. Check the result

The page now shows Imported from Tolt with the same kind of report as the preview. Compare its totals with the Partners and Customers pages in Tolt.

Here is an example with made-up numbers.

Tolt shows 200 partners and 500 customers. The Anderro report shows:

LineNumber
New affiliates190
Keeping their referral code184
Getting a new main code (old links still work)6
Affiliates skipped10
Referred customers carried over480
Customers who are their own affiliate4
Customers skipped20

How to check it:

  • Affiliates: 190 imported + 10 skipped = 200. That matches Tolt's Partners page. Open Skipped and confirm the 10 are the partners who are suspended on Tolt.
  • Codes: 184 kept + 6 with a new main code = 190. Every imported affiliate is in one of the two groups.
  • Customers: 480 carried over + 20 skipped = 500. That matches Tolt's Customers page. The 20 skipped customers belong to the 10 skipped partners.
  • Self-referrals: the 4 customers who are their own affiliate are part of the 480, not extra. They are listed under Imported, with a note.

If a total does not add up, the reason is in the Skipped list. Every skipped record has one.

Run it again

Running the import again is safe. Records that were already imported are recognised and are not duplicated. Only what is new on Tolt is added.

Tolt keeps recording until you switch your site over, so run the import again right before you switch. On the Import page, under New records since the import, press Check for new records. If there is anything new, press Import the new records.

If the key has already been deleted from Anderro, paste a key again first.

Undo an import

You can undo an import as a whole. On the Import page, press Undo this import. Every affiliate, customer and commission that the import created is removed. Records that existed on Anderro before the import are not touched.

Undo before you switch over

Undo is refused once the imported affiliates have clicks, sales or payouts on Anderro. If something looks wrong, undo it before you switch your site over.

Switch over

Switching over means your website stops reporting sales to Tolt and reports them to Anderro instead. Do it in this order:

  1. Install Anderro tracking on your site and connect your payment provider. Follow the Quickstart and the product's Integrations tab. Leave Tolt running while you do this.
  2. Check that a test referral is recorded on Anderro. Open your site through an affiliate link, sign up, and confirm it appears in Anderro.
  3. Run the import one more time. This picks up affiliates, customers and commissions that are new on Tolt since your first import.
  4. Remove Tolt's script and server calls from your site. From now on, sales are only reported to Anderro.
  5. Tell your affiliates. See the next section.
  6. Finish on Tolt. Settle or stop payouts on Tolt according to your commissions choice. Revoke the Tolt API key. When you are ready, close the Tolt program.

Why the order matters:

  • Until step 1 is done, affiliate links are not tracked on Anderro. If you remove Tolt first, sales in between are credited to nobody.
  • Keep the time between step 3 and step 4 short. A sale that is recorded only on Tolt in that gap is not on Anderro. If that happens, run the import once more after step 4 to pick it up.

Tell your affiliates

After an import, the Import page shows Tell your affiliates. Nothing is sent until you press the send button there. Anderro then sends each imported affiliate one email on your behalf. The email tells them:

  • that the program has moved to Anderro
  • their commission terms
  • their referral link, and that links they already shared keep working
  • any balance that was carried over
  • how to get in. Affiliates who are new to Anderro create their login with the same email address, which connects them to their imported account. Affiliates who are already on Anderro find the program in their dashboard.

Before you send:

  1. Add a short note of your own if you want one, for example why you moved and who to contact. It is shown in the email as you wrote it.
  2. Press Preview to read the email. There are two versions, one for affiliates who are new to Anderro and one for those who already have an account.
  3. Press Send me a test to get the email in your own inbox.
  4. Press the send button and confirm. The page shows how many were sent.

What to expect:

  • Replies go to the person who pressed send.
  • Each affiliate gets the email once, however many times you press send. If you import new affiliates later, only they are emailed.
  • Three days after the first email you can send one reminder to the affiliates who have not signed in yet.
  • An email that failed is tried again the next time you press send.

Send it after you have switched over

Until Anderro tracking is installed on your site, the email leaves out the referral link and does not say that existing links keep working, because that would not be true yet. Send it after the switch-over so affiliates get the full email.

Other platforms

Only Tolt can be imported this way today. If your program is on Rewardful, FirstPromoter or another platform, request early access.

Questions

Yes, once Anderro tracking is installed on your site. Each affiliate's Tolt code is kept as their main code, or kept as an alias when the main code had to change. This applies to the affiliates you imported, so choose Everyone if every link must keep working. A link also needs its ending to be on: see Link endings.

Will affiliates be emailed without me?

No. The import sends nothing. Affiliates hear about the move only when you send the email from Tell your affiliates.

What happens to commissions already paid on Tolt?

They are never paid again. With Leave them out they are not imported. With the other two choices they are recorded on Anderro as already paid, so affiliates see them as history.

Can I undo it?

Yes. Undo this import removes everything the import created. Undo is refused once the imported affiliates have clicks, sales or payouts on Anderro, so check the result before you switch over.

Is my API key safe?

The key is sent over HTTPS, stored encrypted and never shown again. Only the import job uses it, and only to read. It is deleted when you finish or cancel, and automatically after 7 days. Because Tolt keys can also write, revoke the key in Tolt when you are done. After that the key is useless to anyone.