Void Conversions Remotely

From Offerit
Revision as of 11:35, 21 August 2014 by OfferitJames (talk | contribs)

Jump to: navigation, search

You can void any conversion recorded remotely by sending a post to the process_void.php script. This will allow you to automate voiding transactions in your system so you don't have to manually void customer transactions in the Customers Admin. (

When a void is recorded for a transaction the amount of revenue recorded for that transaction will be deducted from your Profit and Loss reports. Also, your offers will (by default) remove any affiliate payout given to the affiliate for that conversion.

A transaction may only be voided if you can supply the orderid of the transaction. This means that your system must create a unique orderid when a conversion occurs and the pixel for this conversion must contain the orderid.

Enabling Void Posts

Before voids can be posted to your network, you must first enable this feature in the Misc section of the Configuration Admin by checking the setting named "Allow Remote Void Posts".

Posting a Void Transaction

Parameters:

  • orderid - The orderid of the conversion/transaction you are trying to void.
  • type - (optional) This is an optional parameter for recording voids. (Can be sent as either "void" or you can omit this parameter.)

Example

http://yourdomain.offerit.com/signup/process_void.php?orderid=12345

Posting a Chargeback Transaction

Parameters:

  • orderid - The orderid of the conversion/transaction you are trying to chargeback.
  • type - (optional) This is a required parameter for recording chargebacks. (This must be set to "chargeback".)
  • cost - (optional) This is an optional parameter that can be set to add a transaction fee for processing the chargeback. By default, this fee will be deducted from the referring affiliate's payout. For example, If you want the chargeback fee to be $25.00, you would set this parameter to "25.00".

Example

http://demo.offerit.com/signup/process_void.php?orderid=12345&type=chargeback&cost=25.00

Reversing a Void or Chargeback Transaction

Parameters:

  • reverse - This parameter is required to reverse a void/chargeback transaction and must be set to 1.

Security

To protect your system and prevent fraudulent transactions from being recorded, you can restrict which IP addresses can send posts to process_void.php. To do this, edit the landing page of the offer you are trying to restrict postbacks for, then enter the comma-separated list of IP addresses in the field named "Secure Landing Page Void IPs".

Example

11.22.33.44,55.66.77.88