Partner Fees | BlindPay Docs

What are Partner Fees?

Partner fees allow you to earn revenue from every transaction processed through BlindPay. You can add these fees on top of each transaction, and BlindPay will automatically collect them from your customers throughout the month.

Types of Partner Fees

You can configure two types of fees:

Percentage Fees: A percentage of the transaction amount
Flat Fees: A fixed amount per transaction

These fees can be set independently for:

Payins (fiat to stablecoin)
Payouts (stablecoin to fiat)

Configuring Partner Fees

To set up your partner fees:

Go to the BlindPay Dashboard
Navigate to Settings > Partner Fees
Configure your desired fees for both payins and payouts

Partner Fee Tracking in API Responses

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

Partner Fee Amount

Each payin quote and payout quote object includes a partner_fee_amount field that shows the exact amount BlindPay collected for that transaction:

Partner Fee Tracking Object

You'll also see a tracking_partner_fee object that provides real-time status updates on your partner fee:

This tracking object allows you to:

Monitor the status of your partner fee collection
Get the transaction hash when the fee is delivered
Know exactly when the fee was completed

Fee 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'll receive payout.partnerFee or payin.partnerFee webhook 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. This means:

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.

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

Example

Let's say you configure:

A 1% fee for payins
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

Best Practices

Consider your business model when setting fees
Be transparent with your customers about any additional fees
Monitor your fee earnings through the dashboard
Use webhooks to track fee collection in real-time
Check the tracking_partner_fee object in API responses to monitor fee collection status
Ensure the appropriate team members have withdrawal permissions to access partner fee payouts on the first of each month