TRACK UpdateConversionPrice API

Updated on 2014-04-07
Current Version: Version 1
Latest Version: Version 2
Deprecated Version: 
Requests Allowed: GET&SOAP

Summary:

Returns a message "Conversion Updated".

Resource/WSDL Page:

http://<your_domain_here>/api/1/track.asmx?op=UpdateConversionPrice

Parameters

api_key
Required
Type: STRING
Length (Max/Min): 50

Must be a valid API key (existing and not expired)

Example Values: Fo35NRAqvFLXoZxqB4aVMhh

request_id
Required
Type: INT
Length (Max/Min): NA

Allowed formats: "YYYY-dd-mm", "dd-mm-YYYY"

Example Values: 2014-24-04, 24-04-2014

offer_id
Required
Type: INT
Length (Max/Min): NA

Must be an existing Offer ID

Example Values: 123456

add_to_existing
Required
Type: BOOL
Length (Max/Min): NA

Add Amount to Existing Revenue? ["TRUE" = Add, "FALSE" = Overwrite]

Example Values: True

amount
Required
Type: DECIMAL
Length (Max/Min): NA

Revenue to be Added/Overwritten [Use a negative Dollar Amount to Remove Credit]

Example Value: -123.45

mark_as_returned
Required
Type: BOOL
Length (Max/Min): NA

Mark the Conversion as Returned? ["TRUE", "FALSE"]

Example Values: True

note_to_append
Required
Type: STRING
Length (Max/Min): NA

Freeform Notes.  Can be left blank.

Example Values: notes to append

billing_option
Required
Type: STRING
Length (Max/Min): NA

Accepts "ignore_billing", "next_generated_bill", or "latest_generated_bill"

Example Values: ignore_billing

 **Note all optional parameters still need to be passed through in the actual call. These parameters do not need a value (therefore you can use a null value). 

 

Example Request

GET

http://demo.cakemarketing.com/api/1/track.asmx/UpdateConversionPrice?api_key=dNJFmId9rI&request_id=3420071&offer_id=1000610&add_to_existing=TRUE&
amount=15.00&mark_as_returned=FALSE&note_to_append=Here+is+where+I%27m+putting+my+notes&
billing_option=next_generated_bill

 

Sample XML Response:


<update_conversion_price_response>
  <success>true</success>
  <message>Conversion Updated</message>
</update_conversion_price_response>

Example Error Messages:  

Error Message

Likely Cause

Invalid API Key

API Key does not exist or is expired

Conversion Not Found

Conversion cannot be found using the supplied request_id and offer_id