Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Requirements:

  1. Checkout Champ Konnektive Attestation of Compliance (This will be located in the Zip file)

  2. Checkout Champ Konnektive PGP Key (They will require this key in order to encrypt and send files to us)

    1. https://apidocs.konnektive.com/#c5700d03-70a6-4aa3-92ab-bec7cd835c1c

  3. Server Credentials (This is the server that your processor will export files to)

    1. host: 23.253.42.24
      username: storm_media
      password: 8xWPZ4Wq

  4. Import File (The file you will provide to us for import into the CRM. The base file will be provided to you in the Zip)

...

  1. Make the request for an export with your processor. Provide them the server credentials, PGP Key and AOC. Once their requirements for an export have been met they will send the data to the server credentials you provided to them.

  2. Inform us through the Checkout Champ Concierge ticket that the export was completed. We will then decrypt and tokenize the file and provide it to you through the ticket.

  3. Map the export files fields to the Import file. The legacy Data import PDF will provide the field definitions and required columns.

    1. merchantId: Located here: https://crm.konnektive.com/merchants/mids/ Listed under the ID column, this is the merchant future rebills will be processed on.

    2. campaignId: Located here:https://crm.konnektive.com/crm/campaigns/ This the campaign your imported customers will be assigned to.

    3. productId: also known as campaignProductId. Located under the ID column in the Campaign Products Section of the campaign. (Note) This is different from the base productId. Verify that the products you assign are configured correctly ie: One Time or Recurring.

    4. isActiveRecurring: needs to be set to 1 if the product is an Active Subscription.

    5. nextBillDate: is required for active subscriptions and must be in this format

      date (YYYY-MM-DD)

    6. phoneNumber should be formatted like this 5551112222. Do not include parentheses or dashes

    7. You will the other required fields in the Legacy Import PDF or in the Import File CSV which contains all the required columns.

  4. Send us the completed file through the Concierge ticket

  5. We will import a sample of the completed file

  6. Verify the sample. You will want to review the customers, verify the rebills and refunds work. If there are any issues let us know.

  7. If the samples pass the test we will import the rest of the data.

...

  1. What is the merchantTxnId?

    1. This is the processors Transaction Id

  2. (Stripe) What is the externalToken?

    1. Typically in the Stripe file there will be a column with values that look like this (pm_1K9aRtKXsXQBYaESfe5508if) Put those values under externalToken. This is required for rebills and without them your subscriptions will fail.

  3. (Stripe) What is authCode?

    1. Typically in the Stripe file there will be a column with values that look like this (cus_Kmqdn9Nr2wO1MH) Put those values under authCode. This is required for rebills and without them your subscriptions will fail.

  4. Can I put any date in the import file?

    1. No, the dateCreated requires this specific format datetime (YYYY-MMDD HH:MM:SS)

    2. The nextBillDate requires this specific format date (YYYYMM-DD) and is required for Active subscriptions

  5. What if a required field is missing?

    1. In some cases you can use dummy data. For example phoneNumber can replaced with 1111111111 (No dashes or parentheses)

    2. You will need to check with your processor if they will accept the rebill without it. If they will then you should use A token identifying the customer payment source at the 3rd party gateway. This is commonly used to run existing rebills when the full card numbers are unavailable and when gateway-supported. -note: if provided, cardNumber column may be masked with either x's or asterisks.

3. What if I don’t have a required column?

a. In some cases you can substitute with dummy data. EG. phoneNumber can be supplied with 1111111111. You will have to check with the processor you will be transacting with (NMI, Stripe, Auth.net) whether they will allow the subscriptions without the field or will allow dummy data.