Payin developer fees

Overview

Mural allows developers to collect custom payin fees from their users. Fees are set per account and per currency, and stay in place until you change them. These developer fees are automatically withheld from the customer’s payin amount and distributed back to the developer.

Payin developer fees follow these rules:

• The account must belong to a child organization. Send the request with the on-behalf-of header set to that child organization.
• Supported currencies are usd, eur, mxn, brl and ars, and the account must already accept payins in that currency.
• Each fee is a percentage from 0 to 100, with up to 4 decimals. Currencies you don't set charge no developer fee.

Usage

When creating your account using the Accounts API, set the percentage fee you want us to collect on your behalf for each currency in developerFees. 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",
  "developerFees": {
    "payinsDeveloperFees": [
      {
        "type": "usd",
        "developerFeePercentage": 2.5
      },
      {
        "type": "eur",
        "developerFeePercentage": 1.8
      }
    ]
  }
}

Existing account

You can also update the payin custom fees for existing accounts with PUT /api/accounts/{id}/set-developer-fees, using the developer fees endpoint. Only the currencies you send are updated.

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

Collecting fees

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 manager to arrange the details. See Developer fees for how fees are tracked.