Time to read: 5 min
The article covers the following topics:
What is Hold in Affise
'Hold' is one of the conversion statuses, which means that a payment decision is put 'on hold' and will be paid for in a certain period of time. Here you can find more about all statuses of the conversion.
This option allows you to control when the conversion becomes the payable one, as you can pay for the conversion only when it has Approved status.
How does it work
You can find Hold settings here: Offer section -> Offer edit page -> Postbacks tab.
To get the conversion in 'Hold' status, you need to define a certain amount of days or hours in the Hold period field upon passing which the conversion in Hold status will become Approved and eligible for payment. Zeros are set up in each offer by default.
❗ You can select no more than 60 hours/days in the Hold period field.
In Affise system, all the statuses have system values:
1 for Approved status
2 for Pending status
3 for Declined status
5 for Hold status
There is no need to pass &status=5 via postback - if the hold period is defined in the offer, the conversion will be automatically registered as 'Hold'.
When the conversion is registered, you will see it in Statistics -> Conversion slice:
The date there means the day when the conversion will be approved automatically.
Affise system checks conversions statuses and the hold period every 15 minutes. If the hold period is expired, the system turns all Hold conversions into Approved ones.
Hold in hours works in the following way: for instance, you selected 1 hour. If the conversion came at 17:30, it will be approved at 18:30.
If you pass &status=5 via postback without hold period determination in the offer - the conversion will be registered as Hold, and it will remain so until the system starts to turn all Hold conversions into Approved ones.
If you turn the conversion in Hold status into Approved one, it will remain with Approved status even though the Hold period has not expired.
If the conversion has at least one reason to be registered as Declined, it will be Declined.
Where else I can find Hold on the platform
Hold in Statistics
In the following Statistics slices you can see the slide ‘With Hold’:
If the slide is ON, the following columns include conversions in Hold status:
Hold and Affiliates
On the page of Affiliates list, there are the following columns:
Balance: includes payouts for conversions that have statuses selected in the field 'Conversion status in Affiliate’s balance' 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.
Once the conversions become Approved, the numbers in all three columns will be updated respectively in an hour.
❗ When Hold conversion status is not selected in the 'Conversion status in Affiliate’s panel statistics' field in Settings -> Affiliates -> General, Affiliate won’t see Hold conversions on his panel.
❗ Billing for Affiliates does not include conversions in ‘Hold’ status. Find more information about Billings for Affiliates here.
Hold period via API
You can add Hold period to the offer via API by using of these methods:
1) For creation a new offer: https://api.affise.com/docs3.1/#add-offer
2) For editing an existent offer: https://api.affise.com/docs3.1/#edit-offer
Use parameters 'hold_period' and 'hold_type'.
These articles can be helpful:
Should you have any further doubts or questions on working with Hold period, feel free to address them to Affise Support Team via [email protected] or your internal live-chat as long as to contact your dedicated Account Manager.