Void Conversions Remotely

Offerit For Affiliates Automatic SubIDs Affiliate Stats Dumps Linkcode Link Groups Affiliate Custom Pixels Affiliate Host and Post Offerit Affiliate Area Affiliate Account Details Affiliate Account Change Log Affiliate Creatives Affiliate Creatives Search Affiliate Settings Affiliate Custom Pixels Affiliate Linkcodes Affiliate Linkcode Settings Affiliate Login History Affiliate Messages Affiliate Dashboard Dashboard Key Statistics Dashboard Statistics Summary Affiliate Payment History Quick Links Affiliate Referrals Report Affiliate Referring URL Report Affiliate Remote Login Affiliate Signup Affiliate Statistic Filters Affiliate Statistic Views Affiliate SubIDs Offerit Setup Creating Admin Accounts Tracking Domain Edit Affiliate Text Edit CSS Colors Getting Started Admin Offerit Quick-Start Guide Tracking in Offerit Pixel Builder Offerit Postback Examples Replacement Variables Currency Exchange Rates Admin Dashboard The Admin Dashboard Reporting Admin The Reporting Admin Track and Strack   Report Breakdowns Profit and Loss Report Subscription Report Transactions Reports Affiliate Ratios Report Affiliate Managers Report Visitor Actions Report Referral Tier Payouts Report Referral Signup Payouts Report Additional Commissions Report Graphical Affiliate Comparison Report The Single Day Comparison Report Actual Affiliate Payments Report Offers Admin The Offers Admin Offers Offer Setup Affiliate Referrals Tracking Domain Commissions Commission Changes Suppression Lists Pixel Builder ID Numbers Offer Partner Offer/Landing Page Redirection Setting Rules Admin Host and Post Offer Post URLs Offer Goals Affiliates Admin The Affiliates Admin ID Numbers Affiliate Managers Affiliate Referrals Affiliate Activation Admin-Only Settings Affiliate Overrides Creating Admin Accounts In-House Accounts Add Manual Sale Manual Invoice Affiliate Documents Affiliate Enabled Offers Change Affiliate Status Account Changes Advertisers Admin The Advertisers Admin Account Changes Advertiser Invoices Generate Invoice Advertiser Approval Change Advertiser Status Customers Admin Customers Admin Manually Adding a Customer ID Numbers Payments Admin The Payments Admin Payvia Types Payout Periods Payvia Dump Formats Payment Dump Entry Numbers Payment Dump Variables Check Functions Setting Rules Payment Methods Payza Creatives Admin The Creatives Admin Add New Creatives Add New Creative Type Offeritcode Code Builder Track and Strack Setting Rules   Default Creative Types Creative Types Image Banners Flash Banners Dynamic Text Banners Feeds Mailers Video Download Video Embed Page Peels IM Popups Footer Ads Page Ads Overlays Communications Admin The Communications Admin Add News Item Sending Messages Signup Questions Configuration Admin The Configuration Admin Affiliate Signup Postback URL Edit Affiliate Text Edit CSS Colors REST API General Offerit REST API Overview GET /service/ping PATCH /service/set_currency_exchange_rates Advertiser PATCH /advertiser/edit_advertiser POST /advertiser/add_advertiser Affiliate GET /affiliate/get_links GET /affiliate/get_single_link GET /affiliate/search GET /affiliate/decode_trackingcode PATCH /affiliate/edit_affiliate PATCH /affiliate/payvia POST /affiliate/add_affiliate POST /affiliate/affiliate_login_ips Config GET /config/get_global_void_ips GET /config/get_global_post_ips GET /config/get_global_hostnpost_ips POST /config/add_global_void_ip POST /config/remove_global_void_ip POST /config/add_global_post_ip POST /config/remove_global_post_ip POST /config/add_global_hostnpost_ip POST /config/remove_global_hostnpost_ip Creative GET /creative/get_creatives GET /creative/get_creative_fields GET /creative/get_creative_rules PATCH /creative/delete_creative PATCH /creative/edit_creative PATCH /creative/edit_creative_rules PATCH /creative/undelete_creative POST /creative/add_creative POST /creative/add_creative_rule POST /creative/delete_creative_rules Customer PATCH /customer/set_customer_details PATCH /customer/lock PATCH /customer/unlock PATCH /customer/forget GET /customer/export Offer GET /offer/get_conversion_caps GET /offer/check_orderid_exists GET /offer/get_commission_changes GET /offer/get_details PATCH /offer/activate_offer PATCH /offer/edit_landing_page PATCH /offer/edit_offer PATCH /offer/pause_offer PATCH /offer/set_commission_change_payouts PATCH /offer/set_enabled_affiliates PATCH /offer/set_offer_categories PATCH /offer/set_offer_countries PATCH /offer/set_offer_goals PATCH /offer/set_offer_groups PATCH /offer/set_offer_marketing_types PATCH /offer/store_offer_ips POST /offer/add_commission_change POST /offer/add_landing_page POST /offer/add_offer POST /offer/add_tracking_domain Reporting GET /report/profitloss GET /report/transaction Transaction GET /transaction/transaction_payout_preview PATCH /transaction/transaction_update_revenue_by_orderid PATCH /transaction/transaction_update_revenue_by_transaction_hash POST /transaction/process_void POST /transaction/process_chargeback POST /transaction/process_reversal POST /transaction/approve_pending_transaction GET /transaction/click_detail SOAP API (*deprecated*) API Add Affiliate Add Affiliate Sale Add Offer Approve Transaction Creative Types Decode Offeritcode Deny Transaction Disable Affiliate Landing Page Edit Affiliate Sale Enable Affiliate Landing Page Get Affiliate Stats Get Allowed Affiliates Get Landing Page Details Get Offer Details Get Offer List Get Profit Loss Report List Affiliate Details List Affiliate Subaffiliates Ping Set Affiliate Status Set SubAffiliate Status Set Member Details Record Affiliate Click Misc. Rules Freeform Date Affiliate Custom Signup Offeritcode Tracking in Offerit Offerit Logos Void Conversions Remotely

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.
• click_hash/transaction_hash - (optional) The click_hash/transaction_hash of the transaction being voided.
• type - (optional) This is an optional parameter for recording voids. (Can be sent as either "void" or you can omit this parameter.)
• approved - (optional) If you want to void a pending transaction that has been approved, pass in the "orderid" of the pending transaction and set this parameter to "1".

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.
• click_hash/transaction_hash - (optional) The click_hash/transaction_hash of the transaction being charged back.
• 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".

Examples

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

http://demo.offerit.com/signup/process_void.php?click_hash=45a552e2b7ea632.76210061

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