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. 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.
Moov currently supports two types of facilitator fees: total and markup.
totalfee type would be appropriate for billing something like 4.00% per transfer.
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.
100is equivalent to $1.
To collect a fee, you can utilize the
facilitatorFee field on transfer creation. There are a few different options when specifying the fee amount:
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
The facilitator 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. ↩︎