Documentation Index Fetch the complete documentation index at: https://mintlify.com/blindpaylabs/blindpay-node/llms.txt
Use this file to discover all available pages before exploring further.
List Partner Fees Retrieve a list of all partner fee configurations for your instance.
const response = await blindpay . partnerFees . list ();
Response Array of partner fee objects Unique identifier for the partner fee configuration
ID of the instance this fee configuration belongs to
Descriptive name for this fee configuration
Percentage fee applied to payouts (e.g., 0.5 for 0.5%)
Flat fee amount applied to payouts in USD
Percentage fee applied to payins (e.g., 0.5 for 0.5%)
Flat fee amount applied to payins in USD
EVM-compatible wallet address where fees are sent
Stellar wallet address where fees are sent
{ "data" : [ { "id" : "pfee_1234567890" , "instance_id" : "inst_1234567890" , "name" : "Standard Partner Fee" , "payout_percentage_fee" : 0.5 , "payout_flat_fee" : 1.0 , "payin_percentage_fee" : 0.5 , "payin_flat_fee" : 1.0 , "evm_wallet_address" : "0x1234567890abcdef1234567890abcdef12345678" , "stellar_wallet_address" : "GABC123456789DEFGHIJKLMNOPQRSTUVWXYZ" } ], "error" : null }
Create Partner Fee Create a new partner fee configuration.
const response = await blindpay . partnerFees . create ({ name: "Standard Partner Fee" , evm_wallet_address: "0x1234567890abcdef1234567890abcdef12345678" , payout_percentage_fee: 0.5 , payout_flat_fee: 1.0 , payin_percentage_fee: 0.5 , payin_flat_fee: 1.0 , stellar_wallet_address: "GABC123456789DEFGHIJKLMNOPQRSTUVWXYZ" , virtual_account_set: false });
Parameters A descriptive name for this fee configuration
EVM-compatible wallet address (e.g., Ethereum, Polygon, Base) where fees will be sent
Percentage fee to apply to payouts. For example, 0.5 represents a 0.5% fee
Flat fee amount to apply to payouts in USD. For example, 1.0 represents a $1.00 fee
Percentage fee to apply to payins. For example, 0.5 represents a 0.5% fee
Flat fee amount to apply to payins in USD. For example, 1.0 represents a $1.00 fee
Stellar wallet address where fees will be sent for Stellar network transactions
Whether a virtual account is configured for this partner fee
Response Show Created Partner Fee object
Unique identifier for the created partner fee configuration
ID of the instance this fee configuration belongs to
Descriptive name for this fee configuration
Percentage fee applied to payouts
Flat fee amount applied to payouts in USD
Percentage fee applied to payins
Flat fee amount applied to payins in USD
EVM-compatible wallet address where fees are sent
Stellar wallet address where fees are sent
{ "data" : { "id" : "pfee_1234567890" , "instance_id" : "inst_1234567890" , "name" : "Standard Partner Fee" , "payout_percentage_fee" : 0.5 , "payout_flat_fee" : 1.0 , "payin_percentage_fee" : 0.5 , "payin_flat_fee" : 1.0 , "evm_wallet_address" : "0x1234567890abcdef1234567890abcdef12345678" , "stellar_wallet_address" : "GABC123456789DEFGHIJKLMNOPQRSTUVWXYZ" }, "error" : null }
Get Partner Fee Retrieve details about a specific partner fee configuration.
const response = await blindpay . partnerFees . get ( "pfee_1234567890" );
Parameters The ID of the partner fee configuration to retrieve
Response Unique identifier for the partner fee configuration
ID of the instance this fee configuration belongs to
Descriptive name for this fee configuration
Percentage fee applied to payouts
Flat fee amount applied to payouts in USD
Percentage fee applied to payins
Flat fee amount applied to payins in USD
EVM-compatible wallet address where fees are sent
Stellar wallet address where fees are sent
{ "data" : { "id" : "pfee_1234567890" , "instance_id" : "inst_1234567890" , "name" : "Standard Partner Fee" , "payout_percentage_fee" : 0.5 , "payout_flat_fee" : 1.0 , "payin_percentage_fee" : 0.5 , "payin_flat_fee" : 1.0 , "evm_wallet_address" : "0x1234567890abcdef1234567890abcdef12345678" , "stellar_wallet_address" : "GABC123456789DEFGHIJKLMNOPQRSTUVWXYZ" }, "error" : null }
Delete Partner Fee Permanently delete a partner fee configuration.
Deleting a partner fee configuration cannot be undone. Existing transactions using this fee configuration will not be affected.
const response = await blindpay . partnerFees . delete ( "pfee_1234567890" );
Parameters The ID of the partner fee configuration to delete
Response Returns a success response with no data on successful deletion.
{ "data" : null , "error" : null }
Fee Calculation Partner fees are calculated using both percentage and flat fee components:
Total Fee = (Transaction Amount × Percentage Fee) + Flat Fee
Example For a $1,000 payout with:
Percentage fee: 0.5% (0.5)
Flat fee: $1.00
Total Fee = ($1,000 × 0.005) + $1.00 = $5.00 + $1.00 = $6.00
Supported Networks EVM-Compatible Networks The evm_wallet_address can be used on the following networks:
Ethereum
Polygon
Base
Arbitrum
And other EVM-compatible chains
Stellar Network The stellar_wallet_address is used for transactions on the Stellar network.
Make sure to provide wallet addresses for all networks you plan to use. Fees will be sent to the appropriate address based on the network used for the transaction.