Non-API flow

Setup overview

This guide is for partners sending leads to Konduit through a URL (non-API). Use URL parameters only for low-sensitivity tracking and product-selection fields, following the security guidance below.

1. Share the IPs that need to be allowlisted for test and production.
2. Konduit shares the QA URL.
3. Send test leads to the QA URL using the allowed URL parameters.
4. After pre-population is confirmed, Konduit shares the production URL.
5. Use the online dashboard for lead-level data or arrange postback with Konduit.

Parameter reference (guide examples)

Never place sensitive information in query strings. Do not send SSNs, driver’s license numbers, dates of birth, bank routing numbers, bank account numbers, or other sensitive values in URL parameters. Query strings can be exposed through browser history, logs, referrer headers, and analytics. Collect sensitive values only through the secure HTTPS form or authenticated API.

• Only permitted low-sensitivity fields should be passed as URL parameters; the full reference table below does not mean every field may be placed in a URL.
• If you do not have a value, omit the parameter rather than sending a default. The lead can complete the field on the landing page.
• Format: <URL shared by Konduit>?<FieldName1>=<Value1>&<FieldName2>=<Value2>
• Field names are reproduced as supplied. The reference uses Lead_id, while the illustrative URL example uses lead_id; do not assume the two spellings are interchangeable.
• The value for productType must exactly match the value provided by Konduit.
• Example: <QA URL>?productType=PersonalLoan&campaign=social_fb2&sub_affiliate=2342&lead_id=185643&zip=11022&loanAmount=5000

Postback

Setup requirement: These examples are illustrative. Konduit provides partner-specific credentials, authentication, signature, and replay-protection requirements directly during setup. Partners must complete and validate that setup before production. lead_id must be an opaque identifier with no customer data.

The dashboard provides lead-level conversion data in real time that can be downloaded as CSV. URL and webhook postback are also available on request.

https://yourdomain.com?param1=value1&param2=value2

HTTP Status Code: 200 OK

Upon successful receipt of the data, your system should return a 200 OK status to
confirm that the postback was processed correctly.

{
  "lead_id": "12345",
  "amount": "100.00",
  "timestamp": "01/01/2024 01:01:01"
}

{
  "status": "success",
  "message": "Transaction processed successfully."
}

{
  "status": "error",
  "message": "<Reason of Error>"
}