GuidesAPI Reference
Log In
Guides

Payin developer fees

Overview

🚧

Please contact support before using this feature. This feature needs to be enabled before you can use it.

Mural allows developers to collect custom, payin fees from their users set on a per-account, per-currency configuration. These developer fees are automatically withheld from the customer’s payin amount and held on behalf of 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 to arrange the details.