Partner Fees

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):

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 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

Configure partner fees

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

Related

• Webhooks · Payins · Payouts