# FlexFactor

<figure><img src="/files/81K33eavcZrYpLmoXTSD" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
FlexFactor is for decline salvage only. Do not place a FlexFactor gateway on a campaign product or in ATRI gateway profiles.
{% endhint %}

{% hint style="info" %}
FlexFactor is available on Recycle Billing and when retrying initial declines.
{% endhint %}

{% hint style="info" %}
FlexFactor is available for cascades. Add the FlexFactor gateway to an ATRI cascade profile. Then set that cascade profile as a direct cascade on a gateway or as the cascade on an ATRI gateway profile. A cascade requires that ipAddress is passed on the order. FlexFactor cannot process a cascade without it.

Alternatively use the **cascadeAll** option on the FlexFactor gateway to cascade all initial sale soft declines to FlexFactor without the need to create cascade profiles.  This option overrides all cascade profiles.  ipAddress is still required.

Cascades return an instant approval or decline from FlexFactor. There is no wait period as there is with recycle billing or a retry on the Order Details report.
{% endhint %}

#### STEP 1

Go to Gateways > Gateway Integrations. Select FlexFactor. Press the green **+Activate** button.

<figure><img src="/files/BIZvihAjmZanl3Qbg3Nv" alt=""><figcaption></figcaption></figure>

#### STEP 2

Obtain **AppKey, AppSecret, MID #, SiteId, EnvironmentKey,** and **HMACSigningKey** from FlexFactor. Enter them here.  **EnvironmentKey** is the FlexFactor Tokenization Key.

Choose to enter **expiryDays**. This is how long to retry the sale at FlexFactor. Default is 21. Maximum is 21. This value is ignored for cascades.

Choose to cascade all initial sale soft-declines to FlexFactor.  The **cascadeAll** option overrides all existing cascade profiles.

<figure><img src="/files/ZhF2hPVgwFgux3pA3Fsl" alt="" width="375"><figcaption></figcaption></figure>

#### Recycle Billing

Go to Gateways > Recycle Billing

Select FlexFactor as the Gateway for Re-Attempts 4-6 or 7-9 or Final Attempt

<figure><img src="/files/thLmtCaxiWohovFARWiz" alt="" width="563"><figcaption></figcaption></figure>

#### Rerun Initial Declines

Choose the FlexFactor gateway directly when retrying initial declines on the Order Details Report or via the [Rerun Declined Sale API](https://apidocs.konnektive.com/#34638ede-05ec-4f95-8a8d-afd84a28475b). Do NOT retry on an ATRI gateway profile.

Initial Declines (new sales) with recurring products may be sent to FlexFactor. However a successful recovery leaves no payment token to rebill the subscription on the original decline gateway. The next rebill will attempt on the original decline gateway with card number and without cvv. If and when that declines then that can be sent to FlexFactor again through Recycle Billing.

Only Initial Declines are eligible to be re-run via FlexFactor. Re-running Declined Upsales is not supported.

#### FlexFactor Responses

Orders sent to FlexFactor are automatically retried by FlexFactor. The result from FlexFactor is communicated back to CRM.

<table><thead><tr><th width="193">Order Type</th><th width="167">Result</th><th>Action</th></tr></thead><tbody><tr><td>New Sale</td><td>Success</td><td>Order is Complete and fulfillments are processed</td></tr><tr><td>New Sale</td><td>Failure</td><td>Order is Declined. The exception to this is completing a trial. Completing a trial leaves the order status unchanged.</td></tr><tr><td>Recurring</td><td>Success</td><td>Move subscription to the next billing cycle. Fulfillments are processed. Subscription reverts to the previous declined gateway for next scheduled billing.</td></tr><tr><td>Recurring</td><td>Failure</td><td>Subscription is Recycle Failed</td></tr></tbody></table>

#### Send Hard Declines to FlexFactor

By default only Soft Declines are sent to FlexFactor.  This can be overridden using [Decline Mapping](/konnektive-crm/gateway-setup/decline-message-mapping.md).  Map any specific Hard Decline to a Soft Decline.


---

# 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://help.konnektive.com/konnektive-crm/gateway-setup/gateways/flexfactor.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.