> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Sola / Cardknox

> Use your own Sola (Cardknox) merchant account to collect payments from your customers through your Fluz app.

Use your own Sola (Cardknox) merchant account to collect payments from your customers through your Fluz app. You keep your existing Sola account. We add your MID to Fluz and assign it as the payment gateway on your app.

Adding a merchant account is not self-service. Send us the details below and the Fluz Platform team does the setup.

## How it works

**1. Send us your details**

Fill out the request form. Until the form is available, email [platforms@fluz.app](mailto:platforms@fluz.app?subject=Sola%20MID%20request) with everything listed under [What to include](#what-to-include).

**2. We board your MID**

We reply with a secure way to share your xKey. Then we set up your Sola account as a payment gateway merchant account in Fluz.

**3. We assign it to your app**

We assign the MID as the payment gateway on your application and email you when it is ready. This takes 2–5 business days.

## What to include

### Your app

| Detail | Notes |
| :- | :- |
| **Application name or application ID** | From the Developers section of your Fluz dashboard |
| **Environment** | Staging, production, or both. For both, send sandbox credentials for staging and live credentials for production |

### Your Sola account

| Detail | Notes |
| :- | :- |
| **Legal business name** | The business name on your Sola merchant account |
| **Sola account name** | The account name in your Sola portal |
| **MID** | Your merchant ID |
| **MCC** | The four-digit merchant category code on your account |
| **Descriptor** | The text that appears on your customers' card statements |

### Optional

| Detail | Notes |
| :- | :- |
| **Customer service phone number** | The number on your merchant account |
| **Customer service email** | The email on your merchant account |
| **Business address** | The address on your merchant account |

## API credentials

We also need your xKey to connect your MID. Have it ready, but don't include it in the form or your email.

| Credential | Notes |
| :- | :- |
| **xKey** | Your Cardknox API key, from the Sola portal |

> [!WARNING]
>
> **Never email your xKey.** We reply to your request with a secure way to share it.

> [!WARNING]
>
> **Fill in Marketed URLs before you send the request.** List every website or app where you offer Fluz services in the **Marketed URLs** section of your app's settings, on both your staging and production apps. We can't set up a MID for an app that leaves it blank. See [Collect payments from your customers](https://docs.fluz.app/build-a-platform.md#collect-payments-from-your-customers).

> [card] [Email platforms@fluz.app](mailto:platforms@fluz.app?subject=Sola%20MID%20request)
>
> Use the subject line "Sola MID request" and include the details above. Leave out your xKey.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.