Offerit API Add Affiliate Sale
From Offerit
Revision as of 11:54, 16 March 2015 by OfferitJames (talk | contribs)
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