Customer Payment Methods

Overview

When a customer makes a purchase, their payment method is saved for future use — renewal charges, upsells, and subscription retries all use saved cards without requiring the customer to re-enter their details. Customers can review and manage their cards from the Billing tab in their WebApp account profile.

Cards are stored and charged through your configured payment processor. DashNex stores only the display metadata (brand, last 4 digits, expiry) — the actual card data never touches DashNex servers.

The Billing Tab

Customers access their payment methods at Account → Billing. The Billing tab shows:

• All saved payment methods with card brand, last 4 digits, and expiry date
• Which card is set as the default
• DashNex Credits balance (if applicable)
• Buttons to add a new card, set a default, update billing address, or remove a card

Adding a New Card

Clicking Add Payment Method opens a payment form powered by your active processor. The customer selects their processor (if multiple are enabled) and enters their card details in the secure payment element.

The flow uses Stripe Setup Intents under the hood — the card is validated but not charged at this step. Once confirmed, the card is saved for future off-session payments.

1. Customer opens the add card form
2. A Setup Intent is created with usage: off_session
3. Customer enters card details and submits
4. Stripe confirms the setup and saves the card to the customer's Stripe profile
5. The card appears in the Billing tab immediately

Supported Processors

Payment methods are processor-specific. Customers may have cards saved across multiple processors:

Managing Saved Cards

Set Default

The default card is used for all subscription renewals and dunning retries. Customers can change their default card at any time — the next scheduled charge will use the new default.

Update Billing Address

Customers can update the billing name and address associated with a saved card. This information appears on invoices and may be required for address verification by the card issuer.

Remove a Card

Removing a card detaches it from both the DashNex record and the Stripe customer profile. Cards cannot be removed if they are the only payment method on an active subscription — the customer must add a replacement card first.

Updating a Card During Dunning

If a subscription enters a failed-payment state, the customer can recover it by:

1. Opening Account → Billing
2. Adding a new working card or removing the expired one
3. Setting the new card as default

The next dunning retry will automatically use the new default card. No manual intervention is needed — the retry schedule continues as configured.