The default response format is based upon the format of the data submitted. For instance, if you post via query string or form post, a redirect URL will be returned. If a lead is submitted via XML, an XML response is returned and likewise if a lead is submitted via JSON, a JSON response is returned.
Note: When submitting leads you must use one of the following methods:
- FORM POST
- GET QUERYSTRING
- POST XML
- POST JSON
However, the response format can be specified by appending one of the following parameters to the Post URL: ResponseFormat=redirect, ResponseFormat=xml, and ResponseFormat=json.
By posting the desired name value pairs to your post, you will receive the appropriate response back. The list of error codes and error messages you may receive back are located at the bottom of this page.
Example: http://leadgendomain/Lead/123456/SimplePost?ResponseFormat=xml
Ping XML Response:
Successful Ping
<LeadPingResult>
<Accepted>true</Accepted>
<Reason>Buyer Accepted</Reason>
<LeadId>L0067-99AFF</LeadId>
<AcceptedPings>
<LeadPingResponseData>
<PingId>P0067-4D7D0B</PingId>
<Payout>0.00</Payout>
</LeadPingResponseData>
</AcceptedPings>
</LeadPingResult>
Rejected Ping
<LeadPingResult>
<Accepted>false</Accepted>
<ResponseCode>2004</ResponseCode>
<Reason>Rejected by all buyers.</Reason>
<LeadId>L0067-99B0A</LeadId>
</LeadPingResult>
Ping JSON Response:
Successful Ping
{
"Accepted": "false",
"Reason": "Rejected by all buyers.",
"LeadId": "L0067-99B09"
}
Post XML Response:
Successful Lead
<response>
<status>Accepted</status>
<leadId>L0461-95</leadId>
<commissionStatus>Not Approved</commissionStatus>
<commission/>
<successUrl>/Lead/276253/Success</successUrl>
</response>
Rejected Lead
<response>
<status>Rejected</status>
<responseCode>1200</responseCode>
<message>Fname is required.</message>
<failedDataField>Fname</failedDataField>
<failureUrl>
/Lead/276253/Failure/Fields?EC=1200&EM=Fname+is+required.
</failureUrl>
</response>
Post JSON Response:
Successful Lead
"{ "status": "Accepted", "leadId": "L0272-4B879", "commissionStatus": "Not Approved", "commission": null, "successUrl": "/Lead/305768/Success" }"
Rejected Lead
"{ "status": "Rejected", "responseCode": 2004, "message": "Unable to accept lead.", "failedDataField": null, "failureUrl": "/Lead/305768/Failure/Rejected?EC=2004&EM=Unable+to+accept+lead." }"
List of Response Codes:
Note: Your affiliate will receive less information then you on the response reason.
Response Code | Response Message |
0 | Lead was accepted. |
1000 | Campaign is dead and not accepting leads. |
1001 | Campaign is expired and not accepting leads. |
1002 | Campaign is not accepting leads. |
1100 | Click ID is invalid. |
1101 | Affiliate ID is invalid. |
1102 | Simple post is not allowed. |
1103 | Affiliate is suspended and not authorized to post leads. |
1104 | Affiliate is blocked and not authorized to post leads. |
1105 | Affiliate is not authorized to post leads. |
1106 | Sub ID is blocked and not authorized to post leads. |
1107 | Cap has been met. |
1200 | {0} is required. |
1201 | {0} could not be calculated. |
1202 | Posted IP address is not valid. |
1203 | {0} can only contain whole numbers. No decimal points allowed. |
1204 | {0} must be a valid number. |
1205 | {0} is less than the allowed minimum value. |
1206 | {0} is greater than the allowed maximum value. |
1207 | {0} must be a valid date. |
1208 | The length of {0} is less than the allowed minimum length. |
1209 | The length of {0} is greater than the allowed maximum length. |
1210 | {0} does not match the required format. |
1211 | {0} does not contain one of the allowed values from list. |
1212 | {0} format can not be evaluated. |
1213 | {0} contains a value which is not allowed. |
1214 | {0} contains an invalid formula. |
1215 | {0} contains an unknown data field in the formula. |
1216 | {0} could not be validated due to an unexpected problem. |
1217 | Validation Errors. |
1218 | Invalid System Field. |
1300 | Rule Failure. |
1301 | Rule Failure Due To Exception. |
1302 | Click ID Already Used. |
1303 | Fraud Score Failure. |
2001 | Distribution Failure No Tiers Exist for Channel ID {0}. |
2002 | All Tier Rules Failed. |
2003 | All Channel Rules Failed. |
2004 | Rejected by all buyers. |
2005 | Unable to accept lead. Sold lead has hit maximum times it can be sold. |
3000 | An unexpected error occurred. |
3001 | Unauthorized. |
4001 | Invalid Ping ID. |
4002 | Post Values do not match submitted Ping Values. |
4003 | Ping channel has no associated Post channel. |
4005 | Ping Minimum Payout not met. |
You can request a demo to see LinkTrust up close and experience how it can help you, or start your free 14-day trial now.
Need help with this feature or have questions? You can contact our support team at support@linktrust.com