1. Guides
2. Fee plans

Moov offers two pricing models, a flat rate or itemized cost plus plan, which can be assigned to one merchant, or used as a template to assign to many merchants. This guide explains the two plan types and provides detailed information about fees on Moov’s platform.

Plan types

Both pricing models provide the same powerful features and reliable processing - the difference is in how fees are structured. Each fee plan lists the fee type and the amount to charge when the fee is triggered.

You can preview detailed pricing disclosures for both plan types in the Dashboard.

Flat rate pricing

Flat rate pricing is a simplified, predictable pricing plan with a custom flat rate consolidating all processing fees. Flat rate pricing is ideal for:

• Businesses with lower transaction volumes
• Businesses who prioritize predictability over cost optimization

Interchange cost plus pricing

Interchange cost plus pricing is a transparent, itemized pricing plan that marks up card network interchange fees with Moov’s processing fee. This plan type gives your customers visibility into true costs. Interchange cost plus pricing is ideal for:

• Businesses with higher transaction volumes
• Companies seeking to minimize processing costs
• Businesses that value detailed fee transparency
• Those who want to optimize payment strategies based on fee insights

Pricing disclosure acceptance

You are responsible to your merchants for communication regarding pricing models. Any changes or updates to a fee plan must be communicated to and accepted by merchants. If you use Moov’s hosted onboarding process, Moov sends the pricing disclosure with the onboarding link. The disclosure lists the rates in the plan you selected.

View fee plans

To view a merchant’s existing fee plan, navigate to Accounts > Pricing in the Dashboard or use the fee agreements GET endpoint. If you need to make changes to a pricing model, such as increasing fees or changing the billing period, you must contact Moov.

Billable events

Your customer is charged fees which are determined by the assigned flat rate or interchange cost plus plan. A billable event is an action on Moov’s platform which triggers a fee assessment.

Charges & reconciliation

Fees are typically assessed in real-time and deducted from the account’s wallet. For plans with monthly charges, fees are billed on the 1st of each month for the previous billing cycle. When a billable event is triggered, the corresponding fee, calculated based on the account’s fee plan, is debited from the wallet.

Each wallet transaction includes key details to help you understand the charges:

• transactionType: Always set to moov-fee
• source: Indicates the origin of the fee: transfer, dispute, or fee
• memo: Provides a description of the charge, for example, Fee for card payment

For billing purposes, Moov consolidates fees associated with the same source into a single charge. For example, a moovFee for a card payment represents the total of multiple underlying fees assessed for that transfer. In a cost plus pricing plan, this could include interchange, dues and assessments, and processing fees charged together in a single transaction.

Additionally, each transfer will include a moovFeeDetails object, summarizing the total fees charged for that transfer.

1
2
3
4
5
6
7

"moovFee": 223,
"moovFeeDecimal": "2.23",
"moovFeeDetails": {
  "cardScheme": "20.1575",
  "interchange": "2.10",
  "moovProcessing": ".0567",
},

Each moov-fee transaction type is associated with a feeID that contributes to the aggregated charge. Fees are deducted from the wallet immediately after the transfer reaches its final state.

Detailed fee breakdowns are available through the retrieve fees endpoint. This endpoint provides additional insights, such as specific fee names and events that triggered them. You can retrieve a list of fees within a specified time frame or for a particular transferID. For convenience, batch retrieval is available via the list fees POST endpoint, allowing you to request multiple fee records in a single call.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

{
  "accountID": "ec7e1848-dc80-4ab0-8827-dd7fc0737b43",
  "amount": {
    "currency": "USD",
    "valueDecimal": "12.987654321"
  },
  "createdOn": "2019-08-24T14:15:22Z",
  "feeID": "ec7e1848-dc80-4ab0-8827-dd7fc0737b43",
  "feeName": "string",
  "generatedBy": {
    "transferID": "ec7e1848-dc80-4ab0-8827-dd7fc0737b43"
  },
  "walletID": "ec7e1848-dc80-4ab0-8827-dd7fc0737b43"
}

If you need to retrieve a feeID, you can do so with the fees GET endpoint.

Rounding

Moov maintains a standard of rounding to the nearest unit (cents). For example, if the moovFeeDecimal on a card transaction is 0.065, Moov will round the moovFee up to 0.07. If the moovFee is 0.064, we round down to 0.06.

The availableBalance in a wallet will always be rounded down to prevent transfers that exceed the available amount. The availableBalanceDecimal always reflects the precise value remaining in your wallet. If you cash out your wallet for 1204 using the example below, the remaining balance would be 0.0063.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

[
  {
    "grossAmount": 500,
    "grossAmountDecimal": "5.00"
    "fee": 139,
    "feeDecimal": "1.38706"
    "netAmount": 361,
    "netAmountDecimal": "3.61294"
    "availableBalance": 1204
    "availableBalanceDecimal": "12.0463"
  }
]

Facilitator fees

Under this structure, Moov charges your platform a processing fee for each successful payment, which you can pass on to your customers on a per-transfer basis. Failed transfers and additional items that are not supported in this flow are invoiced to your account on a monthly basis.

When you set a facilitator fee, that amount is deducted from the transfer so the destination receives the net amount. Your wallet is credited with the fee once the transfer completes. No fees are incurred if a transfer fails.

Fee types

Moov supports two fee structures:

• Total: A flat percentage fee charged to the destination, for example, 4.00% per transfer
• Markup: An amount added on top of Moov’s fee, for example, Interchange + 1.90% & $0.10

When creating transfers, specify your fee using either total/totalDecimal or markup/markupDecimal. The decimal versions support up to nine decimal places. Only one of total or totalDecimal, or markup or markupDecimal can be used.

Guidelines

Below is a summary of general guidelines for facilitator fees:

• To pass through exact processing costs with no markup, set markup to 0
• Anything above your cost must be calculated in your system and the markup must be sent to Moov as a dollar amount in the transfer
• Your fee cannot exceed the maximum limits:
  • For total fees: Must be less than the transfer amount
  • For markup fees: Depends on transfer type:
    • card-acquiring: Total (markup + Moov fees + estimated interchange) must be less than transfer amount
    • rtp or push-to-card: Total (markup + Moov fees) must be less than transfer amount
• If no facilitator fee is specified, your wallet is debited to cover your processing fees

Charges & reconciliation

Card payments include Moov fees with interchange and other costs finalized at completion. Fee breakdowns appear in moovFeeDetails on each transfer:

• interchange: Determined at the time of settlement and charged upon completion for Visa, Mastercard, and Discover
• discount: Determined at the time of settlement and charged upon completion for American Express
• cardScheme: Network fees charged at completion
• moovProcessing: Your agreed-upon processing rate with Moov

Your platform receives the facilitator fee and is debited the moovProcessing fee, visible in the facilitator-fee transaction in your wallet.