Payout developer fees

Overview

Mural allows developers to collect custom fees on each payout. These developer fees are automatically withheld from the payout amount and distributed back to the developer.

Payout developer fees follow these rules:

• The fee is set on each payout, in payoutDetails.developerFee.developerFeePercentage. Nothing is stored, so send it on every payout that should carry a fee.
• The payout must be made on behalf of a child organization, using the on-behalf-of header.
• The fee is a percentage from 0 to 100 of the source token amount, and only applies to fiat payouts.
• Payouts sent from a USD balance (tokenSymbol of USD) don't support developer fees yet. Payouts sent from USDC do.

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"
        },
        "developerFee": {
          "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

A payout's fee is held until the payout settles, and returned if the payout fails. Your available fee balance is closed on the 1st of each month at 00:00 UTC and paid out to you. Please contact our support team or account executive to arrange the details. See Developer fees for how fees are tracked.