Facilitator fees can be applied to any type of transfer, and the amount specified will be deducted from the transfer so that the destination receives the transfer amount net of fees. The fee amount is credited to your wallet once the transfer is completed.
Moov charges a fee to your platform to process most payments. Depending on the transfer type, the Moov fee may be incurred at the time of the payment.
Moov currently supports two types of facilitator fees: total and markup.
total: Utilizing the total facilitator fee type allows you to charge a flat fee to the merchant regardless of what interchange and other costs amount to. The
totalfee type would be appropriate for billing something like 4.00% per transfer.
markup: The markup facilitator fee type is what you want to use if you want to bill an amount on top of the Moov fee. Note that the Moov fee includes interchange and other pass-through costs which can vary from transfer to transfer. The
markupfee type would be appropriate for billing something similar to Interchange + 1.90% & $0.10. The markup fee is debited from your platform account wallet, not the merchant.
In place of
markup, you have the option to use
markupDecimal, which support cents in fractions, up to nine decimal places. Only one of
markupDecimal can be used.
facilitatorFee object in the API for more details.
100 is equivalent to $1.
To collect a fee, you can utilize the
facilitatorFee field in the create a transfer
POST request. When specifying the fee amount, there are a few different options:
markup option to achieve Interchange+ pricing.
You can either pass on your exact cost, setting markup to 0, or indicate an additional amount you want to collect on top of your cost. Keep in mind that anything above your cost must be calculated in your system and the markup must be sent to Moov as a dollar amount.
For example, let’s assume the following:
- $100.00 transfer
- Interchange = $2.00
- Facilitator pricing = Interchange + 0.90% & $0.10
- Merchant pricing = Interchange + 1.90% & $0.10
In this scenario, the total Moov fee is $3.00. The goal is to net a total of interchange ($2.00) plus 1.90% ($1.90) and $0.10 ($0.10) = $4.00 from the transfer amount. A markup of $1.00 is required.
markup = merchant pricing - facilitator pricing - interchange
total to charge a flat fee, regardless of the Moov fee.
If you want to charge 4%, calculate the total to
0.04 * transferAmount to know what amount to send Moov, in this case $4.00.
If the transfer amount is $100 and the
total facilitator fee is $4, the net amount received by the destination is $96, and you will receive $4 minus the Moov fee in your wallet.
If the total fee is less than the Moov fee, your wallet will be debited instead of credited.
facilitatorFee field is left blank, Moov will apply a default fee of $0 and the destination will receive the gross amount of the transfer. Your platform wallet will be debited any Moov fees that apply.
facilitatorFee field in the transfer request, you can set a markup or total fee. See examples of each kind of fee below:
Once a transfer is successfully created, Moov automatically creates subsequent transactions representing the associated fees on that transfer. These fees will not be charged until the transfer successfully reaches the destination.
- The total fee amount cannot exceed the transfer amount
- If you have not specified a facilitator fee and Moov charges a fee at the time of transfer1, Moov will debit your wallet the amount of the Moov fee
- If your wallet does not have enough funds to cover the fees, the debits will result in a negative wallet balance
Moov charges a fee (
moovFee) to your platform account for card transfers, and rounds to the nearest cent. The
moovFeeDecimal provides the details of the precise fee charged, up to nine decimals.
Transfers with the
card-payment payment method as the source incur a Moov fee that includes interchange and other passthrough costs that are finalized at the time the transfer is completed.
See more details in the get transfer API response.
Your account receives the full
facilitatorFee and is debited the
moovFee. You’ll see each debit and credit in your Moov wallet.
Moov currently only applies fees on card payments. Other payment methods are billed separately. ↩︎