Time to read: 12 min.
The article covers the following topics:
Billing for Affiliates: what is it
Affise allows generating billings (payments, invoices) for affiliates. In brief: the system automatically counts payouts presented in conversions and generates a billing that can be given to affiliates by Affise clients.
The main purpose of the Billing for Affiliates feature is to help Affise clients to calculate expenses that are to be paid to affiliates.
❗ Affise does not pay money on its own. The Billing for Affiliates feature serves only for expenses calculation and giving the prepared invoice to an affiliate.
To ease the work with billings off, you can use the Tipalti plugin.
Where can I find the Billing for Affiliates feature in Affise?
The Billing for Affiliates can be found in the Admin panel -> Billing -> Affiliates.
Upon getting to a Billing page, you will see three sections:
1. Forms for billing generation:
2. Form for billing searching and its status changing:
3. List of existent billings.
Which permissions should be granted to let generate a billing?
All permissions are granted here: Admin panel -> Users -> User management.
You need to get Read/Write access for Affiliates editing:
Otherwise you won't see 'Billings for Affiliates' subsection at all.
If you have Deny access, but there are affiliates in Read or Write lists of exceptions, you will be able to create the billing only for those affiliates and their offers.
How can I generate the billing?
Affise allows generating the billing by using one of two forms.
The first one allows the generation of the billing for the certain period of time. It has three fields:
Date: this field is responsible for the date, which payouts in conversions will be counted. The current date is set up by default. You may choose any other date in the past.
Generate for: if no particular affiliate is chosen, the billings will be generated for all affiliates.
Exclude: you can exclude some particular affiliates from the billing.
If a partner in the 'Generate for' field is selected and the 'Exclude' field is not active, the billing will be generated only for this partner. If a partner in the 'Generate for' field is not selected and the 'Exclude' field is active, the billing will be generated for all affiliates who are not excluded from the billing.
Note: you may write any note that will be reflected in the column ‘Note’, on the billing view page, in .pdf version of the billing as well as on Affiliate panel. If there is no written note, then the period of time, which payouts for conversions are counted for, will present in the relevant column in the Billings list.
The second one allows the generation of the billing for the certain sum of money for the certain affiliate. It has four fields:
Affiliate: the certain affiliate should be chosen.
Sum of money: the certain sum of money should be typed.
Currency: a currency should be chosen. The currency can be activated or assigned as a default one in Settings.
Note: same as in case of the first form.
❗ The second form generates a billing for the sum that is not always equal to the sum you've indicated.
If you set up 100$, and the payout for all the conversions is 3$, then the billing is generated for 102$ - the most proximate sum but no less than an indicated sum.
If you set up 100$, and you have conversions with different payouts, for example 40$, 40$, 25$, 15$ etc., then the billing is generated for 105$. The system takes conversions that go to billing in full within the indicated sum and one more next conversion to finish generating the billing.
If the sum for all the conversions is less than the indicated sum - the billing is generated for the sum that is available.
❗ Whichever form is used, the date from which billing will be generated is the date of the last payment. If no payment were made in the past - payouts for conversions would be counted from the first conversion of the affiliate (all affiliates).
Payouts for conversions of Approved status only are included in the billing.
If you use the first form and there are conversions with different currencies, then one billing for one currency will be generated. Thus multiple billings might be generated.
If you want to generate the billing for referral affiliate, then the first form only should be used.
How can I search for the billing and change its status?
The form for Billing searching has five fields:
Date: choose the period of time during which you want billings to be shown up.
Affiliate: choose the certain affiliate who you want to find the billing for. If no certain affiliate is chosen, then billings for all affiliates will be shown up.
Status: choose the status of the billing.
Payment system: choose the payment system used in billings that you want to be shown up.
Amount of billings: choose the amount of billings you want to be shown up per page.
You may change the status of the certain billing or several billings in bulk:
There is the full list of statuses available in Affise:
Waiting: the billing is prepared, but not completed. You can edit, delete it, view the details, conversions included, and download the version in .pdf format.
Completed: the billing is closed. You can view the details, conversions included, and download the version in .pdf format.
Partly paid: the billing is prepared, but not completed.
Pending: the billing is prepared, but not completed.
Sent to tipalti - relevant when Tipalti plugin is used
Waiting payment tipalti - relevant when the Tipalti plugin is used.
Declined - relevant when the Tipalti plugin is used.
How can I see details of certain billing?
You need to choose the billing. The list of billings contains several columns:
ID: ID of the certain billing, that you can find in the User activity log.
Affiliates: the certain affiliate whom the billing belongs to.
Payment system: payment system used for this particular billing.
Payout: the sum of money.
Status: see the full list of the statuses.
Date: the date of the billing generation.
Note: the note, written in Note field or the period of time, which payouts for conversions are counted for.
Actions: possible actions (view, download the version in .pdf format, edit, delete).
To view the details, click on the 'Eye' sign. You will see this page:
Offer title: if an offer title is changed in the future - no changes will be observed on the billing view page and the downloaded invoice and Affiliate panel. If the offer was deleted, the relevant string would be empty.
Count: total number of conversions included in the billing.
Price and currency: the total sum of payouts. You can see several strings for the same offer - it depends on the number of Payouts set up in the particular offer in the Payouts section. For example, the offer contains two different goals with two different payouts. Thus if the affiliate has payable conversions for both goals - two strings with the sum of money will be shown up.
Total and currency: the certain sum of money paid under the payout met by the affiliate in the certain conversion.
❗ If the payout is less than 0.0001, it is rounded to tenth decimal, if the payout is equal to 0.0001 or bigger - it is rounded to fourth decimal.
At the bottom of the page, there is a ‘Conversions’ button. If you click on it, you will see the list of conversions included in the billing.
You can click on the offer name - then you will be led to the offer view page. You can also click on the conversion ID, which will lead to the conversion view page. The first conversion is the newest one, the last conversion (located at the bottom of the page/on the last page) is the oldest one.
If the conversion is from the previous billing period was not included in the previous billing because it was approved or created after the previous billing creation, the conversion will be highlighted. You can see the explanatory message.
There is an opportunity to export this table as an Excel file by clicking on this sign:
All conversions shown on the certain page will be exported.
How to edit the billing?
To edit the billing, click on the 'Pen' sign. You will be led to the edit page:
Here you can change the details regarding Payment account, Status, Comment, and Note. The information you will write in these fields does not influence the sum of money and the process of actual billing payment. The information in these fields will appear in .pdf version of the billing, on the billing view page, as well as on the billing page on Affiliate panel.
At the bottom of the page, there is a 'Correction' option:
With this option, you may add the needed sum of money to the billing with the comment. This sum of money can be deleted until the billing has Complete status.
❗ The option of billing editing is available only when the billing has any status, except ‘Complete’.
What is an export option?
The export section allows getting information about all or certain billings in a text format.
You need to choose one/several/all billings firstly. There is an opportunity to choose delimiter, format, and the needed fields, the number of strings. There is an opportunity to create a custom field (Text field) and to type some additional note or comment. Then you need to click on an ‘Export’ button, and you will receive all the data in the text format.
Billing Auto-generation option
There is an opportunity to let the system generate billings automatically. In Settings -> Affiliates -> General you can set up a rule for invoices auto-generation:
Disabled: disable auto-generation;
Weekly: invoices will be generated each Monday 00:01 for the previous calendar week;
Bi-weekly: invoices will be generated once in two weeks on Monday 00:01 for the previous 2 calendar weeks;
Monthly: invoices will be generated on the first day of the new month at 00:01 for the previous calendar month.
Timezone, set up in Settings -> General.
The relevant comment will be added to the invoice: ‘Created by Auto-generation schedule’:
All such billings are generated in Waiting status by default. See the section ‘How can I search for the billing and change its status’ to know how to change the status of the billing.
If there is already generated billing in the system, which partially matches the period of time, that the auto-generated billing has, the following happens: the auto-generated billing will be created from the date of the last conversion, included to the already generated billing.
If there is already generated billing in the system, which fully matches the period of time, that the auto-generated billing has, the following happens: the auto-generated billing will not be created.
Billing won’t be generated, if:
The Affiliate does not have Active status;
The Affiliate does not have a payment system for the currency of the payable conversions;
The Affiliate does not have payable conversions at all.
Billing on Affiliate panel & Affiliate edit page
Billing on Affiliate panel
Before starting to work with billings, an affiliate should choose a payment system in the relevant currency. He should go to his Profile to the relevant section:
If the Affiliate has several payment systems for the same currency, he can choose the main payment system by clicking on the ‘Mark payment system as main’ button. If there is no main payment system, the upper latest payment system is used by default. Only one payment system can be marked as main, so we recommend to add only one system for one currency.
After you created the billing, it becomes visible on the Affiliate panel in the Payments section.
Unlike the billing view page on the Admin panel, there is no opportunity to view certain conversions on the Affiliate panel, included in the particular billing.
Billing on the Affiliate edit page
You can add a payment system on the Affiliate edit page on the Admin panel. Go to Affiliates -> Affiliate management -> Certain affiliate edit page and scroll a bit down.
The list of available payment systems is pulled from the list of payment systems presented in Settings -> Content -> Payment systems.
The coherence of Billing for Affiliates, Statistics, and Affiliate Balance
The coherence of Billing for Affiliates and Statistics
You can always check which conversions are already paid. To do that, go to Statistics -> Conversions slice. You will see the filter:
Unpaid: conversions, not included in the billing;
Waiting: conversions, included to the billing, that has any of statuses, except Complete;
Paid: conversions, included to the billing, that has Complete status only.
Statuses are updated every 24 hours.
Thus you can always compare the billing and the Statistics:
In Conversion slice of Statistics and the list of conversions, included in the billing;
In Daily slice of Statistics. See column Total - Payouts. This column shows payouts only for Approved conversions (if the slider ‘With Hold’ is off).
The coherence of Billing for Affiliates and Affiliate Balance
On the page of Affiliates list, there are the following columns:
Balance: includes payouts for conversions that have statuses selected in the Conversion status in Affiliate’s balance field in Settings > Affiliates > General.
Hold: includes payouts for conversions that have Hold status only;
Payout: includes payouts for conversions that have Approved status only. Thus the sum in the column ‘Payout’ only is available to be paid to an affiliate.
The sum of money in all three columns is reflected for payouts for unpaid conversions only (conversions, not included in the billing).
Once the billing for the certain affiliate is generated, the sum of money, included in the billing, is charged off in ‘Balance’/’Hold’/’Payout’ columns. As the billing includes payouts for conversions with Approved status only, the payouts for conversions in Hold status will remain in Balance and Hold columns. If you delete the billing, the sum of money will be returned to all three columns.
The sum of money in all three columns is updated each hour, and thus if you deleted the billing and now want to create a new one for the same Affiliates, you need to wait for an hour.
❗ If the affiliate is not in Active status, his balance will remain at the point when the affiliate became banned/not active.
1) Does Affise pay money on behalf of it?
No, Affise only provides the option of generating billings as a paper, that can be given to the affiliate via Affiliate panel/E-mail/other services or in real life.
2) Can I delete billing in Complete status?
No. You only can view the details about this billing or get its version in .pdf format.
3) I generated the billing for an affiliate, and I see that it contains only new conversions. I have another billing created before for the same affiliate, but it is not closed. Why do I see only new conversions in the new billing?
Two billings can’t contain the same conversion. Once the billing is created, payouts for conversions are ‘blocked’, and neither can be changed inside the billing not can be included to the next generated billing.
4) How can I get the version of the billing in .pdf format?
On the page with the list of the billings, click on the Printer sign:
5) Which payment system chosen on Affiliate profile is considered as a default one?
The upper latest payment system is used by default if no payment system is marked as the Main one.
6) How does the generation of billings is logged in User activity log?
See Case No. 4 in our guide on the User activity log.
7) Can I manage Billing for Affiliates via API?
Yes, you can manage Billing for Affiliates via API. You can read how to do it here.
The following articles can be helpful:
If you still have any questions left on Billing for Affiliates feature, feel free to address them to Affise Technical Support Team via [email protected] as long as to contact your Dedicated Account Manager.