> For the complete documentation index, see [llms.txt](https://docs.yifi.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yifi.io/economy-and-integration/partners-portal.md).

# Partners Portal

## Partners Portal

The Partners Portal is your dashboard for earning and withdrawing commissions from YiFi Swap. Whether you embed our API in your own product or share a referral link, every attributed swap earns you a share of the trading fee.

{% hint style="info" %}
For the exact fee split and how commissions are calculated, see the [Fees](/economy-and-integration/fees.md) page. This page focuses on how to access and use the Partners Portal. 
{% endhint %}

### Who it is for

The portal supports **two account types**, chosen at registration:

<table data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><strong>👤 Individual</strong></td><td>Creators, KOLs, community members. </td><td><ul><li>1 APY Key</li><li>No team members.</li><li>Monetization only through referral links</li></ul></td></tr><tr><td><strong>🏛️ Company</strong></td><td>Integrators, wallets, dApps, exchanges. </td><td><ul><li>up to 3 API Keys</li><li>May invite team members</li><li>Monetize through API keys  and referral links</li></ul></td></tr></tbody></table>

An Individual account works with the affiliate program only.&#x20;

A Company account additionally unlocks company details, team management, and API keys for programmatic swap attribution.

### Two ways to monetize

#### 1. API integration (Partner)

Embed YiFi Swap in your product and pass your [API key](/api-reference/general.md) with every swap request. Swaps created through your key are attributed to your account, and you earn a share of the fee on each one.

This path is available to **Company** accounts.

#### 2. Referral links (Affiliate)

Share a referral link. When a user swaps after arriving through your link, you earn a share of the fee on their swaps.

This path is available to **both** account types.

{% hint style="warning" %}
A single swap earns through one attribution channel only. If a swap carries both an API key and a referral code from the **same** account, the referral commission is skipped. Attribution never stacks on itself.
{% endhint %}

### Getting started

{% stepper %}
{% step %}

### Create an account

Register with your email and choose **Individual** or **Company**. If someone referred you, enter their referral code during sign-up.
{% endstep %}

{% step %}

### Verify your email

We send a six-digit code to your email address. Enter it to activate your account.&#x20;
{% endstep %}

{% step %}

### Add a payout wallet

Add at least one wallet address to your whitelist. Payouts are only ever sent to whitelisted addresses. Supported chains: EVM, Bitcoin, Solana, Tron.
{% endstep %}

{% step %}

### Start earning

Create an API key (Company) or a Referral link (both types), and integrate or share it.&#x20;
{% endstep %}
{% endstepper %}

### Portal sections

#### Personal

Manage your name, Telegram handle, email, and password. Email and password changes are confirmed with a code sent to your current email address.

{% hint style="danger" %}
Changing your email locks withdrawals for 24 hours as an anti-fraud measure.
{% endhint %}

#### Company

Available to Company accounts. Edit company details (name, website, category, country), manage your team, and maintain company payout wallets.

Team members are invited by email. Roles determine permissions: an **owner** can edit company data, manage the team, and manage wallets, while a **member** has read access to the relevant sections.

#### API Keys

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

Available to Company accounts. Create up to five keys, label them, and enable or disable them individually.

Pass your key in the request header when creating a swap:

```http
x-api-key-partner: <your-api-key>
```

{% hint style="danger" %}
The full API key is shown **once**, at the moment you create it. Store it securely. If you lose it, you must generate a new key. The portal only ever displays a short prefix afterwards, so you can tell your keys apart.&#x20;
{% endhint %}

#### Affiliate

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

Create referral links, each with its own label and unique code, and track performance per link: clicks, sign-ups, conversions, and earnings.

A referral link looks like this:

```
https://yifi.io/?ref=<your-code>
```

You can create multiple links to attribute different campaigns or channels separately.

#### History

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

A unified list of every swap attributed to your account, from both API keys and referral links. Filter by status, source, provider, date range, or search term, and export the results to CSV.

Each record shows the provider, source, tokens and amounts sent and received, USD volume, transaction hashes, commission, and status.

#### Withdrawal

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

Review your balance, broken down by coin, and request payouts.

Withdrawals are reviewed and settled manually. A request moves through these states:

| Status         | Meaning                                             |
| -------------- | --------------------------------------------------- |
| **Pending**    | Request received, awaiting review                   |
| **Processing** | Payout is being sent on-chain                       |
| **Completed**  | Funds sent; a transaction hash is attached          |
| **Failed**     | Request could not be completed; a note explains why |

{% hint style="info" %}
Part of your commission may be paid in the original swap token rather than a stablecoin. Token prices fluctuate and can affect your total USD balance, so we recommend withdrawing regularly to limit exposure.
{% endhint %}

#### Withdrawal requirements

Before a withdrawal request is accepted, all of the following must be true:

* Your withdrawable balance is above $50 equivalent.
* Your email has not been changed in the last 24 hours.
* The destination wallet was added more than 24 hours ago.
* You have no other pending withdrawal.

These conditions protect your funds against unauthorized access.

### FAQ

<details>

<summary><strong>Can I be both a Partner and an Affiliate?</strong> </summary>

Yes. A Company account can hold API keys and referral links at the same time. Each swap is attributed to a single channel, and a swap is never credited twice to the same account.

</details>

<details>

<summary><strong>How is my commission calculated?</strong></summary>

Commission is a share of YiFi's trading fee, calculated on swap volume and normalized to USDT. See [Fees](/economy-and-integration/fees.md) for the exact figures.

</details>

<details>

<summary><strong>Which networks can I receive payouts on?</strong></summary>

Whitelisted wallets support EVM, Bitcoin, Solana, and Tron. When requesting a withdrawal you choose the receive coin and network.

</details>

<details>

<summary><strong>Why was my referral code rejected at sign-up?</strong> </summary>

The code did not match an existing referral link. Check for typos, or ask your referrer to confirm the code.

</details>

&#x20;