Offerit API Add Affiliate Sale
From Offerit
Revision as of 10:17, 3 January 2012 by OfferitRobC (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
- 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
- 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
- currency - OPTIONAL: The three-letter abbreviation of the currency type
- time - OPTIONAL: The time the sale occurred as a unix timestamp or mysql date format
NuSOAP Example
This example continues from the main article NuSOAP Example:
$values = Array(
'orderid'=>'ABCDEFGHI',
'amount'=>1,
'offeritcode'=>'Mi4yLjEuMS4wLjAuMC4wLjAuMC4wLjA',
'customer'=>Array(
'firstname'=>'Ben',
'lastname'=>'Warren'
)
);
$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
Server Request/Response
Request:
<?xml version="1.0" encoding="ISO-8859-1"?><SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:tns="urn:offeritapiadmin_wsdl"><SOAP-ENV:Body><tns:set_aff_sales_add xmlns:tns="urn:offeritapiadmin_wsdl">
<orderid xsi:type="xsd:string">ABCDEFGHI</orderid>
<amount xsi:type="xsd:string">1</amount>
<offeritcode xsi:type="xsd:string">Mi4yLjEuMS4wLjAuMC4wLjAuMC4wLjA</offeritcode>
<customer xsi:type="tns:Member">
<firstname xsi:type="xsd:string">Ben</firstname>
<lastname xsi:type="xsd:string">OfferIt</lastname>
<currency xsi:type="xsd:string">USD</currency>
<time xsi:type="xsd:string">1319475600</time>
</tns:set_aff_sales_add></SOAP-ENV:Body></SOAP-ENV:Envelope>
Response:
<?xml version="1.0" encoding="ISO-8859-1"?><SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body><ns1:set_aff_sales_addResponse xmlns:ns1="urn:offeritapiadmin_wsdl">
<message xsi:type="xsd:string">Add Success</message><customerid xsi:type="xsd:int">124</customerid><orderid xsi:type="xsd:string">ABCDEFGHI</orderid>
</ns1:set_aff_sales_addResponse></SOAP-ENV:Body>
</SOAP-ENV:Envelope>
