---
title: Partner Fees
description: Configure percentage or flat fees on payins and payouts, then withdraw the accumulated revenue monthly.
---

## What it is

A partner fee is a charge you add on top of each transaction processed through BlindPay. BlindPay automatically collects it from your customers throughout the month and releases the balance to you for withdrawal.

## How it works

You can configure two types of fees, set independently for payins (fiat to stablecoin) and payouts (stablecoin to fiat):

| Type            | Description                          |
| --------------- | ------------------------------------ |
| Percentage Fees | A percentage of the transaction amount |
| Flat Fees       | A fixed amount per transaction       |

### Collection and distribution

Partner fees follow a **monthly collection and withdrawal cycle**:

- Fees are automatically collected from your customers during each transaction throughout the month.
- All collected partner fees are **accumulated over the calendar month**.
- On the **first day of the following month**, the total partner fee balance is released and becomes **available for withdrawal** by an authorized user with the appropriate permissions.
- You receive `payout.partnerFee` or `payin.partnerFee` [webhook](/docs/essentials/webhooks) events as fees are collected.
- Track fee collection status through the `tracking_partner_fee` object in API responses.

### Invoice deduction

BlindPay automatically deducts the amount of your outstanding invoice from the accumulated partner fees before making the balance available for withdrawal:

- At the end of each monthly cycle, BlindPay calculates the total partner fees collected.
- The invoice amount owed by you (the client) to BlindPay is **automatically subtracted** from that total.
- The **remaining balance** is then released and made available for withdrawal on the first day of the following month.

You never need to manually pay your BlindPay invoice — it is handled automatically, and you receive the net amount directly.

### Tracking in API responses

When you retrieve payin or payout objects through the API, you see detailed information about partner fees:

- Each payin quote and payout quote object includes a `partner_fee_amount` field that shows the exact amount BlindPay collected for that transaction.
- A `tracking_partner_fee` object provides real-time status updates: the collection status, the transaction hash when the fee is delivered, and when the fee was completed.

### Example

Configure a 1% fee for payins and a $2 flat fee for payouts.

For a $100 payin:

- Your customer pays $101 ($100 + 1% fee)
- $1 is collected as partner fee for that transaction
- The API response will show `partner_fee_amount: "100"`

For a $100 payout:

- Your customer pays $102 ($100 + $2 flat fee)
- $2 is collected as partner fee for that transaction
- The API response will show `partner_fee_amount: "200"`

Monthly settlement example:

- Total partner fees collected in January: $500
- Your BlindPay invoice for January: $250
- Amount available for withdrawal on February 1st: **$250**

## Prerequisites

::c-prerequisites
::

## Configure partner fees

1. Go to the [BlindPay Dashboard](https://app.blindpay.com/){target="\_blank"}
2. Navigate to `Settings > Partner Fees`
3. Configure your desired fees for both payins and payouts

## Related

- [Webhooks](/docs/essentials/webhooks) · [Payins](/docs/essentials/payins) · [Payouts](/docs/essentials/payouts)