Surcharge fees, taxAmount deprecation & more | Moov Documentation

Surcharge fees

Surcharge fees on credit card transactions are now available with Moov API v2026.07.00. Surcharge fees are optionally enabled, and must follow card brand caps and state and federal regulations. Surcharges can be added to:

When creating a transaction, a surcharge fee can be added to the request in amountDetails. See the main surcharge guide or any of the API links above for more details. You must contact Moov to enable surcharging and start the registration process.

Note that API v2026.07.00 is considered in-development until the final release in July.

Tax amount

The taxAmount field is being deprecated in Moov API v2026.07.00 onwards. Taxes can now be added to amountDetails. This affects general transfers, payment links, and invoices.

Ask

{
  "amountDetails": {
    "tax": {
      "currency": "USD",
      "valueDecimal": "8.25"
    }
  }
}

This is a breaking change when updating to v2026.07.00.

Drop payment method theme updates

The payment method Drops theme has been updated. The new theming better supports verification and more closely matches Moov Dashboard flows.

Legacy capability reminder

Note that the following capabilities are legacy capabilities and will be fully deprecated in a future API version:

Update capabilities as needed, to the following:

See the capabilities guide for more information.

Bug fixes

Moov is constantly improving.