Payin developer fees

Overview

🚧

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

Mural allows developers to collect custom payin fees from their users. Fees are set on a per-account, per-currency configuration. These developer fees are automatically withheld from the customer’s payin amount and distributed back to the developer.

Usage

When creating your account using the Accounts API, set the percentage fee you want us to collect on your behalf for each specific currency. We will deduct both the custom fee you set and the platform fees already charged by Mural from the original deposited amount.

See below for an example where we are depositing 10,000 USD to Acme LLC:

Example fee breakdown

Mural platform exchange fee: 0.4%

Custom payin developer fee: 0.5%

Total variable fee: 0.9%

What your user sees:

1. Payin fiat amount: 10,000 USD
2. Calculated fees: 0.9% * 10,000 USD = 90 USD
3. The account will be credited: 9,910 USDC

What you get:

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

Example request

{
  "name": "My account",
  "description": "Custom payin fee added",
  "developerFeesInfo": {
    "payinsDeveloperFees": [
      {
        "currency": "usd",
        "developerFeePercentage": 2.5
      },
      {
        "currency": "eur",
        "developerFeePercentage": 1.8
      }
    ]
  }
}

Existing account

You can also update the payin custom fees for existing accounts using the set developer fees endpoint

{
  "payinsDeveloperFees": [
    {
      "type": "eur",
      "developerFeePercentage": 0.5
    }
  ]
}

Collecting fees

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