Payout developer fees

Overview

🚧

Please contact support before using this feature, as it needs to be enabled.

Mural allows developers to collect custom, per-payout recipient fees from their users. These developer fees are automatically withheld from the a payout request amount and distributed back to the developer.

Usage

When creating your payout request using the Payouts API, set the percentage fee you want to collect. Your user will pay both the custom fee you set and the platform fees already charged by Mural (see getFeesForTokenAmount to calculate Mural's fees).

See below for an example where we are sending 10,000 USDC to Acme LLC:

Example fee breakdown

Mural platform exchange fee: 0.4%

Custom developer fee: 0.5%

Total variable fee: 0.9%

What your user sees:

1. Payout token amount: 10,000 USDC
2. Calculated fees: 0.9% * 10,000 USDC = 90 USDC
3. Recipient receives: 9,910 USD (or the local fiat equivalent)

What you get:

1. Developer fee you receive for the month (assuming just one payout): 50 USDC credited to your Organizations Mural Account.

{
  "sourceAccountId": "af8bafd9-a623-4979-949f-3a5a2272c05b",
  "payouts": [
    {
      "amount": {
        "tokenAmount": 10000,
        "tokenSymbol": "USDC"
      },
      "payoutDetails": {
        "type": "fiat",
        "bankName": "Chase Bank",
        "bankAccountOwner": "Acme, LLC",
        "fiatAndRailDetails": {
          "type": "usd",
          "symbol": "USD",
          "accountType": "CHECKING",
          "bankAccountNumber": "11111111",
          "bankRoutingNumber": "2222222222",
          "phoneNumber": "+57111111111"
        },
        "developerFeePercentage": 0.5 // collect 0.5% fee on top of mural's platform fee
      },
      "recipientInfo": {
        "type": "business",
        "name": "Acme LLC",
        "email": "[email protected]",
        "physicalAddress": {
          "address1": "Street 123",
          "country": "US",
          "state": "TX",
          "city": "Austin",
          "zip": "78731"
        }
      }
    }
  ],
  "memo": "Test memo"
}

Collecting fees

Fees are settled and paid out monthly on an agreed upon date. Please contact our support team or account executive to arrange the details.