Offerit API Add Affiliate Sale

From Offerit
Jump to: navigation, search
Offerit
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

This function allows you to add a sale for a specific affiliate. To use this function, you must make a SOAP call with the following parameters:

  • orderid - OPTIONAL: Your unique orderid that will be associated with the Offerit customer record (This is a value you determine on your end and pass it in)
  • amount - The amount spent on the offer by the customer (optional)
  • offeritcode - This can be either the encoded, un-encoded, or shortname version of the OfferIt Code. You can take this code out of the URL during a conversion and just pass it along. This will tell Offerit which offer, landing page, commission, and affiliate this traffic is for.
  • customer - OPTIONAL: The name of the array used to pass in customer data with the following elements:
    • username - The customer's User Name
    • subscriptionid - The customer ID used to identify this subscription for any future transactions
    • password - The customer's Password
    • firstname - The customer's First name
    • lastname - The customer's Last name
    • address1 - The customer's Address
    • address2 - The customer's Address 2
    • zip - The customer's Zip Code
    • city - The customer's City
    • country - The customer's Country
    • state - The customer's State
    • ip - strtolong value of the customers IP
    • shipping_firstname - The customer's Shipping First name
    • shipping_lastname - The customer's Shipping Last name
    • shipping_address1 - The customer's Shipping Address
    • shipping_address2 - The customer's Shipping Address 2
    • shipping_zip - The customer's Shipping Zip Code
    • shipping_city - The customer's Shipping City
    • shipping_country - The customer's Shipping Country
    • shipping_state - The customer's Shipping State
    • phone - The customer's Phone Number
    • email - The customer's Email Address
    • mailok - Can Offerit send the customer an Email?
    • custom1 - Store custom data about the customer
    • custom2 - Store custom data about the customer
    • custom3 - Store custom data about the customer
    • custom4 - Store custom data about the customer
    • custom5 - Store custom data about the customer
    • refurl - The referring url of the customer
  • currency - OPTIONAL: The three-letter abbreviation of the currency type
  • time - OPTIONAL: The time the sale occurred as a string representation of a date

NuSOAP Example

This example continues from the main article NuSOAP Example:

$values = Array(
    'orderid'=>'ABCDEFGHI',
    'amount'=>1,
    'offeritcode'=>'Mi4yLjEuMS4wLjAuMC4wLjAuMC4wLjA',
    'customer'=>Array(
        'firstname'=>'Ben',
        'lastname'=>'Offerit'
    )
);
   
$result = $client->call('set_aff_sales_add', $values, 'offeritapiadmin_wsdl');

Sample Output

On success:
  array(3) {
    ["message"]=>string(11) "Add Success"
    ["customerid"]=>int(124)
    ["orderid"]=>string(9) "ABCDEFGHI"
}
   
On error:
      error message