Configure Affirm - Konnektive

This guide walks you through configuring Affirm at checkout in Konnektive.

🚧

Affirm will work with Form-code and landers that connect to Konnektive via Direct API. This will NOT work with Order Entry.

Step 1: Create the Affirm gateway

1/. Go to Gateways > Gateway Integrations and select the Affirm button.
2/. Click +Activate.
3/. Enter the following information specific to Affirm:

  • public_api_key - Obtained from Affirm
  • private_api_key - Obtained from Affirm
    4/. Click the green Create Gateway button to save your changes and create the gateway.

Step 2: Assign the gateway

Assign the gateway to campaign products.

Step 3: Set up the checkout page

A checkout page should be secured with HTTPS. A non-secured call to the Affirm gateway will be rejected.

Pass paySource=PREPAID and prepaidType=AFFIRM on the import order API call from your checkout page. Do not pass any other card information.

You can also use hidden input fiends on the page:

<input type="hidden" name='paySource' value="PREPAID">
<input type='hidden' name='prepaidType' value='AFFIRM'>

Alternatively, you can pass in the forceMerchantId parameter in the order import API call. Note that this will only work for one time sales, it will not work with recurring transactions. See below for the forceMerchantId parameter description. For more information, refer to Konnective's API documentation.

ParameterTypeDescription
forceMerchantIdIntegerThe merchantId from Konnektive CRM. Transactions will run against the specified merchant.

The Konnective integration with Affirm supports our Authorization system; however, you must enable the Capture On Shipment in Campaign Shipping Settings for this function to work. Once you mark the fulfillment records in a shipped status, the Capture action will initiate.

In Konnective's order import API Call, pass in the Transaction ID from the Authorization on Affirm’s end using the preAuthMerchantTxnId parameter.

Step 4: Finalize integration

❗️

Important

If you don't follow the steps below, you'll receive invalid request responses when attempting a sale.

To complete the integration, you'll need to supply two required values to Konnektive:

1/. Go to CRM > Products to import images onto your products in the Base Product list. This allows Konnective to supply the item_image_url to Affirm, which is required.
2/. Pass in the errorRedirectsTo parameter on each Affirm Import Order call. This allows Konnektive to supply the item_url to Affirm, which is required.