Recommended API Flow

Full API Documentation: https://apidocs.konnektive.com/?version=latest

It is not necessary to use every page listed below. However, the pages that you do use should contain the API calls listed within that section to give you the most data within your Konnektive instance.

Presell Page

1. Call Import Click

• pageType=presellPage

• userAgent=User Agent Header, used for reporting on browser and device type

• requestUri=The URL that the user requested when they landed on the page (Ex. https://mylander.com/nutra/?affId=AF54B33412&c1=fb&c2=5000234)

  • use affId to grant affiliate credit

  • passed values are case sensitive and must match with the affiliate profile’s Passed Values

  • Url encode this value to prevent breakage from passing the ampersand

• httpReferer (optional, for use with UTM filters) = The URL of the previous webpage from which a link to the currently requested page was followed.

  • may be the same value as requestUri. httpReferer must include the UTM code(s)

Lead Page

1. Call Import Click - pageType=leadPage - send sessionId returned from first Import Click call if not first call**

2. Call Import Lead - partial can be created as soon as you have firstName, lastName, emailAddress or phoneNumber (campaignId and API credentials will also need to be sent) - Send sessionId parameter returned from Import Click to link order to session You can continually call Import Lead as the customer fills their information into your forms - send orderId parameter returned from the first Import Lead call

Checkout Page

1. Call Import Click - pageType=checkoutPage - send sessionId returned from first Import Click call if not first call*

   1. Use fraudPixel=1 if using option 1 for the Device Data Collector Pixel (Fraud Manager and Kount)
2. You can call Import Lead again if updating/expanding partial information
3. Call Import Order - send orderId parameter if already exists and sessionId

   1. Call Confirm PayPal - Only use if paySource=PAYPAL on Import Order with Legacy PayPal workflow - Please view our PayPal documentation for full instructions

Upsell Pages 1+

1. Call Import Click - pageType=upsellPage1-4 - send sessionId returned from first Import Click call
2. Call Import Upsale - include orderId and sessionId

Repeat each step for each upsell page

Thank you Page

1. Call Import Click - pageType=thankyouPage - send sessionId returned from first Import Click call
2. Call Confirm Order (optional) to send Order Confirmation Email Immediately

---

Flowchart

70KB

Recommended API Flow-2.pdf

pdf

---

API Descriptions

Import Click - https://api.konnektive.com/landers/clicks/import/

The Import Click API allows you to track visits to your landing pages in the CRM Reporting.

**On the first Import Click call you must pass the url encoded requestUri. The first Import Click call is also where you should pass the userAgent and httpReferer values. Upon a successful call, the API will return a sessionId for the funnel session. This sessionId must be sent on subsequent API calls made from the funnel in order to tie the clicks to the partial order or complete order that is placed.

---

Import Lead - https://api.konnektive.com/leads/import/

The Import Lead API allows you to add new leads to the CRM.

---

Import Order - https://api.konnektive.com/order/import/

The Import Order API allows you to create new orders.

---

Confirm Paypal - https://api.konnektive.com/transactions/confirmPaypal

The Confirm Paypal API allows you to complete orders on your pages using the Paypal Express Checkout button.

---

Import Upsale - https://api.konnektive.com/upsale/import/

The Import Upsale API allows you to add one-click upsales to existing orders.

---

Confirm Order - https://api.konnektive.com/order/confirm/

The Confirm Order API will immediately send confirmation auto responder emails to the customer.

---