> For the complete documentation index, see [llms.txt](https://docs.makapay.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.makapay.io/features/referral-system.md).

# Referral System

Earn rewards by referring merchants to MakaPay. As an agent, you set a markup on each merchant you refer and earn 90% of that markup on every transaction they process.

***

## How It Works

### Agent Markup Model

Every merchant pays the same flat 1% platform fee, whether they sign up directly or through you. When you refer a merchant, you choose how much of that 1% is your markup. Your earnings come directly from the markup you set, and MakaPay keeps the rest.

```
┌─────────────────────────────────────────────────────────────────┐
│                     Fee Breakdown                               │
│                                                                 │
│  Platform fee:         1% (always)                              │
│  Agent markup:         0.25% or 0.50% of it (you choose)        │
│  MakaPay keeps:        1% − your markup                         │
│  Network fee:          $0.10 per transaction                    │
│                                                                 │
│  Total merchant fee = 1% + $0.10                                │
└─────────────────────────────────────────────────────────────────┘
```

### Earnings Split

| Recipient     | Share             | Description                                   |
| ------------- | ----------------- | --------------------------------------------- |
| Agent         | **90%** of markup | Your commission on every transaction          |
| Upline/Mentor | **10%** of markup | Goes to whoever referred you                  |
| MakaPay       | 1% − markup       | The rest of the platform fee (0.75% or 0.50%) |
| Network       | $0.10 flat        | Processing fee (not shared)                   |

If you have no upline, the 10% goes to a MakaPay fallback account.

***

## Markup Options

| Markup Level | Total Merchant Fee | MakaPay Keeps | Agent Earns (90%) | Upline Earns (10%) |
| ------------ | ------------------ | ------------- | ----------------- | ------------------ |
| 0.25%        | 1% + $0.10         | 0.75% of tx   | 0.225% of tx      | 0.025% of tx       |
| 0.50%        | 1% + $0.10         | 0.50% of tx   | 0.45% of tx       | 0.05% of tx        |

***

## Example Scenarios

### Scenario 1: Full Chain (Agent + Upline)

```
Alice (upline) → referred → Bob (agent) → referred → Charlie (merchant)

Bob set a 0.50% markup on Charlie.

Charlie processes a $1,000 payment:

Total fee:   1% + $0.10 = $10.10
Markup pool: $1,000 x 0.50% = $5.00

Distribution:
├── Bob (Agent, 90% of markup):     $5.00 x 90% = $4.50
├── Alice (Upline, 10% of markup):  $5.00 x 10% = $0.50
├── MakaPay (1% − markup):          $1,000 x 0.50% = $5.00
└── Network (processing fee):       $0.10
```

### Scenario 2: Agent With No Upline

```
Bob (agent, no upline) → referred → Charlie (merchant)

Bob set a 0.25% markup on Charlie.

Charlie processes a $1,000 payment:

Total fee:   1% + $0.10 = $10.10
Markup pool: $1,000 x 0.25% = $2.50

Distribution:
├── Bob (Agent, 90% of markup):     $2.50 x 90% = $2.25
├── Fallback (10% of markup):       $2.50 x 10% = $0.25
├── MakaPay (1% − markup):          $1,000 x 0.75% = $7.50
└── Network (processing fee):       $0.10
```

### Scenario 3: Direct Merchant (No Agent)

```
Charlie signed up directly (no referral code).

Charlie processes a $1,000 payment:

Total fee:   1% + $0.10 = $10.10

Distribution:
├── MakaPay:               $10.00
└── Network:               $0.10
```

***

## Vault Deposits

Your markup also applies when a merchant you referred uses the MakaPay Vault. The Vault charges a fixed 1% fee on each deposit, and your markup is paid out of that 1% the same way:

| Your Markup | Your Share of the Vault Fee | On a $1,000 Deposit ($10 fee)        |
| ----------- | --------------------------- | ------------------------------------ |
| 0.25%       | 25% of the fee              | $2.50 (you earn $2.25, upline $0.25) |
| 0.50%       | 50% of the fee              | $5.00 (you earn $4.50, upline $0.50) |

* Vault commissions appear in your Referral Dashboard within about an hour of the deposit completing.
* They are always credited in a stablecoin. When the Vault fee was taken in a non-stablecoin (for example ETH), you are credited its USD value at the time of the deposit, in USDT on the same network (USDC where USDT is not available).
* Vault deposits on Solana do not earn commission yet.

***

## Getting Started

### 1. Generate Your Referral Code

1. Go to **Dashboard > Referrals**
2. Click **Generate Referral Code**
3. Your unique 8-character code is created (e.g., `ABC12345`)

Requirement: 5 completed payments with received amount > 0, or admin bypass.

### 2. Share Your Code

Share your referral code or link:

* Direct code: `ABC12345`
* Referral link: `https://app.makapay.io/signup?ref=ABC12345`

### 3. Set Your Markup

When you refer a merchant, choose your markup rate:

* **0.25%** -- You earn 0.25% of each transaction; MakaPay keeps 0.75%
* **0.50%** -- You earn 0.50% of each transaction; MakaPay keeps 0.50%

The merchant pays 1% + $0.10 either way.

***

## Withdrawing Earnings

### How It Works

Agent earnings accumulate off-chain. You can request a payout at any time -- there are no withdrawal windows or monthly cycles.

### Minimum Withdrawal

* **$0.10 USD** per token/chain combination

### Withdrawal Process

1. Go to **Dashboard > Referrals > Withdraw**
2. **Select which balances to pay out** — every available token/chain combination has its own checkbox. Defaults to all selected; untick any you want to leave accruing
3. Enter your recipient wallet address
4. Enter the **6-digit 2FA code** from your authenticator app
5. Click **Confirm Withdrawal**
6. Funds arrive in your wallet (one on-chain transfer per selected token/chain)

### 2FA Requirement

Withdrawals are gated by two-factor authentication (TOTP) on your Clerk account. If you don't have 2FA set up, the dialog will block the withdraw flow and link to your account settings to enable it. Supported apps: Google Authenticator, 1Password, Authy, any RFC 6238 TOTP authenticator.

### Selective Withdrawal

You don't have to cash out everything at once. An agent earning across USDT, USDC, and ETH on multiple chains can pay out just the USDT this week and leave the rest accruing. Locked earnings can't be re-selected until the in-flight withdrawal completes or fails.

### Fees on Withdrawal

* Gas fees deducted from earnings
* MakaChain: $0.10 flat transfer fee
* Other chains: Variable gas cost

***

## Referral Dashboard

### Earnings Summary

View earnings grouped by token and chain:

| Token | Chain     | Total Earned |
| ----- | --------- | ------------ |
| USDT  | Polygon   | $25.00       |
| USDT  | MakaChain | $8.50        |
| USDC  | Ethereum  | $12.00       |

### My Network

| Merchant  | Markup | Joined | Your Earnings |
| --------- | ------ | ------ | ------------- |
| user\_xxx | 0.50%  | Jan 5  | $15.00        |
| user\_yyy | 0.25%  | Jan 8  | $5.00         |

***

## Rules & Limitations

### One Level of Agent Earnings

* You earn 90% of your markup on merchants you referred
* Your upline earns 10% of your markup
* No earnings beyond this single upline level

### One Code Per Account

* Each user can only apply ONE referral code
* Code must be applied during signup
* Cannot change referral code once applied

### No Self-Referral

* Cannot use your own referral code
* System blocks self-referral attempts

### Fallback When No Upline

When an agent has no upline, the 10% that would go to a mentor is sent to a MakaPay fallback account. The agent still receives their full 90%.

***

## FAQ

### How is the merchant's fee determined?

* **Direct merchants** (no agent referral): Flat 1% + $0.10
* **Agent-referred merchants**: The same 1% + $0.10. The agent's markup (0.25% or 0.50%) is paid out of the 1%, not added on top.

### What markup should I choose?

The merchant pays 1% + $0.10 no matter which markup you choose, so the markup only decides how the 1% is split between you and MakaPay. 0.50% maximizes your per-transaction earnings.

### Can I change the markup for a merchant after signup?

Contact support to adjust markup rates for existing merchants.

### How often can I withdraw earnings?

Anytime. There are no withdrawal windows. Earnings accumulate off-chain and you can request a payout whenever your balance meets the minimum ($0.10 per token/chain).

### What happens to old earnings?

Existing earnings from before this update remain unchanged. The new model applies to future payments only.

### What if I was referred by another agent?

You automatically become their "downline." When your referred merchants process payments, your upline (the agent who referred you) earns 10% of your markup. This does not reduce your 90% share.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.makapay.io/features/referral-system.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
