# Konnektive

## Create An API User

In order to grant LTV Numbers access to your data via the API, you must create an "API User" inside of your CRM account

1. Log into the CRM side of [CheckoutChamp](https://crm.checkoutchamp.com/) / [Konnektive](https://crm.konnektive.com/) 
2. Create an API User by following the [instructions here](https://konnektive.atlassian.net/wiki/spaces/KCKB/pages/222986302/Create+An+API+User) and note the additional instructions below as you complete the steps 
3. Go to Admin > Users and click the + button in the top right to create a new user as follows:
   * **Username:** "ltv\_numbers\_api" or something similar to clearly identify the LTV Numbers API user
   * **Email Address:** Your email address
   * **Access Level:** "Api User"
   * **IP Whitelist:** "GOOGLE"
   * **Password:** Generate or choose a secure password and save it for a later step and for your records
     * **IMPORTANT!** Do not use an ampersand (&) character in your password
   * **Allowed API Endpoints:** Select "Coupon" and all permissions that contain "Query" as shown below, then click Create
     * Hint: use ctrl + f to help you find "query" on the page

<figure><img src="/files/0F89iNzdCfRaY6A9S2Mw" alt=""><figcaption></figcaption></figure>

## Connect To Konnektive Via API

Grant LTV Numbers access to your data via the API User you created in the above steps, then sync your data

1. [Log into LTV Numbers](https://app.ltvnumbers.com)
2. In LTV Numbers’ side navigation bar, go to the "Settings" tab
3. Click the "Connect with Konnektive" button in the integrations list and fill in the required information:
   * **API Username:** "ltvnumbers-api" or the same username from the "Creating An API User" section
   * **API Password:** The same password from the "Creating An API User" section
   * **Account Name:** The name of your Konnektive or CheckoutChamp account
   * **Account Username:** The username you use to sign into your Konnektive or CheckoutChamp account
4. Click "Connect" to create the integration and be taken into it's settings
   * Note: no data is synced until you complete the steps below
5. Pick an appropriate date range to import your existing data, and an appropriate sync frequency to import your data going forward to meet your analysis needs
   1. Note: we recommend syncing at least the past year of data
6. Select the timezone that your Konnective account profile is set to. The timezone can be found be going to your account inside Konnektive, and then looking for "Timezone" inside the Account Information.
   * Note: This value must be set properly now to ensure that times are interpreted correctly. Incorrectly setting this value can result in payment times being incorrectly offset from the true value. Changing this property later can corrupt your data unless you set the date range to "All Time" and resync your data.
7. Click "Sync Data"
   * Note: this process may take some time to complete

## Limitations & Notes

* Chargeback dates and times&#x20;
  * LTV Numbers' Refunds amount is calculated by adding up all refunds **and chargebacks** that occurred **within the selected date range**.&#x20;
    * Note: This is how our users and our expert team expect to see this data presented.&#x20;
  * Konnektive's Transaction Summary and Transaction Details reports and exports show chargebacks for **transactions within the selected date range** that were **charged back at any point in time.**&#x20;
    * This is a limitation of Konnektive's handling of chargebacks in their data structure by labeling transactions as charged back, rather than including a chargeback as a transaction with it's own date separate from the transaction.
      * Note: Konnektive handles refunds as separate transactions from the initial purchase so refunds do not have the same problem as chargebacks.&#x20;
  * Thus LTV Numbers' Refunds amount and the amount of Konnektive's Refunds + Chargebacks are not the same.
* Timezones
  * Konnektive shows data in the time zone set in your account settings.
  * LTV Numbers defaults to choosing your local timezone wherever you are using it (which could change while traveling).&#x20;
    * Set the LTV Numbers timezone for your Konnektive integration (to match the timezone of your Konnektive account for example), noting the on screen information to preserve data accuracy.&#x20;
  * Thus to compare LTV Numbers and Konnektive data, you may need to account for timezone differences in your date range selections.&#x20;
* "Partial orders" in Konnektive are like abandon carts - the visitor started filling out the checkout form but did not make a payment or complete their purchase. Therefore no transaction occurred.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ltvnumbers.com/data/konnektive.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.