---
title: Smarter Payment Visibility & Enhanced Error Messaging | 2025-04-23
description: New low balance warnings and clearer payment failure messages help Mothership customers resolve issues faster, avoid failed checkouts, and maintain smoother quoting and billing flows.
---

[Skip to content](https://help.mothership.com/smarter-payment-visibility-enhanced-error-messaging-2025-04-23#main-content)

[![](https://help.mothership.com/hs-fs/hubfs/unnamed-1.png?width=150&height=15&name=unnamed-1.png)](https://mothership.com)

Open main navigation

Close main navigation

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Mothership Help Center](https://help.mothership.com/?hsLang=en)
2. [Product Updates / Changelog](https://help.mothership.com/product-updates-changelog?hsLang=en)

# Smarter Payment Visibility & Enhanced Error Messaging | 2025-04-23

## New low balance warnings and clearer payment failure messages help Mothership customers resolve issues faster, avoid failed checkouts, and maintain smoother quoting and billing flows.

**Release Date:** 2025-04-23

We’ve released two improvements to make payment flows in the Marketplace smoother, clearer, and easier to resolve — both **before** checkout and **during** payment attempts.

#### **1. Low Balance Warning for Terms Customers**

Customers using payment terms will now see a dismissible toast banner when their remaining balance drops below 20%.

**What it does:**

- Warns customers early to prevent failed checkouts
- Links directly to past-due invoices for quick resolution
- Returns customers directly to the quote they were working on after payment
- Banner persists until dismissed or the balance issue is resolved

This gives terms customers better visibility and helps prevent unexpected payment failures at checkout.

#### **2. Enhanced Payment Failure Messaging at Checkout**

We’ve upgraded checkout with clear, user-friendly explanations when a card is declined, replacing cryptic payment processor codes.

**What’s new:**

- Top Stripe decline codes mapped to straightforward, plain-language messages
- Clear next steps to resolve the issue
- Banner stays visible until dismissed

**Example:**

- **Stripe code:** `insufficient_funds`
- **Customer message:** *“Please use an alternative payment method or ensure sufficient funds are available before retrying.”*

This makes troubleshooting faster and reduces friction for customers completing a payment.

#### **Impact**

These updates provide:

- Better visibility into low-term balance issues
- Faster resolution of failed payments
- Clear, actionable checkout messages
- Fewer failed checkouts and reduced customer frustration

#### **What to do next**

No action is required.

- Terms customers will see the low-balance banner when applicable.
- All customers will automatically receive the enhanced checkout messages if a payment fails. 

- [FAQs](https://help.mothership.com/faqs?hsLang=en#main-content)

    - [Technical Questions](https://help.mothership.com/faqs?hsLang=en#technical-questions)
- [Getting started](https://help.mothership.com/getting-started?hsLang=en#main-content)

    - [Access Plan](https://help.mothership.com/getting-started?hsLang=en#access-plan)
- [General](https://help.mothership.com/general?hsLang=en#main-content)

    - [Billing](https://help.mothership.com/general?hsLang=en#billing)
    - [Quoting and Booking](https://help.mothership.com/general?hsLang=en#quoting-and-booking)
    - [Shipping](https://help.mothership.com/general?hsLang=en#shipping)
    - [Tracking](https://help.mothership.com/general?hsLang=en#tracking)
    - [Support](https://help.mothership.com/general?hsLang=en#support)
    - [Claims and Insurance](https://help.mothership.com/general?hsLang=en#claims-and-insurance)
- [Reports](https://help.mothership.com/reports?hsLang=en)
- [Integrations](https://help.mothership.com/integrations?hsLang=en)
- [Glossary](https://help.mothership.com/glossary?hsLang=en)
- [Account](https://help.mothership.com/account?hsLang=en#main-content)

    - [Notifications](https://help.mothership.com/account?hsLang=en#notifications)
- [Podcast](https://help.mothership.com/podcast?hsLang=en)
- [Product Updates / Changelog](https://help.mothership.com/product-updates-changelog?hsLang=en)
- [Terms & Policies](https://help.mothership.com/terms-policies?hsLang=en)

Copyright © 2026, Mothership Technologies, Inc.