Skip to main content

Payment Methods

Payment methods are managed from Workspace Settings > Billing > Payment Methods.

All card handling is backed by Stripe. Harmony does not store raw card numbers or CVC values.

Who can manage payment methods​

Payment method access depends on billing permissions:

  • billing:read:all lets you view billing pages.
  • billing:update:all lets you set a default payment method.
  • billing:delete:all lets you remove a non-default payment method.
  • billing:create:all is required for adding payment methods when the add flow is available.

By default, billing permissions are admin-level permissions.

Viewing saved payment methods​

The Payment Methods page shows saved cards and other payment methods on file for the organization.

Each row can show:

  • Payment type.
  • Last four digits.
  • Expiration date.
  • Default or active status.
  • Available actions.

The default payment method is what Stripe uses for automatic renewals and retries.

Setting a default payment method​

If more than one payment method exists and you have permission:

  1. Go to Workspace Settings > Billing > Payment Methods.
  2. Find the payment method you want to use.
  3. Click Set as Default.

The selected method becomes the default for future Stripe charges.

Removing a payment method​

You can remove a non-default payment method if you have permission.

  1. Find the payment method in the list.
  2. Click the remove action.
  3. Confirm removal.

The default payment method cannot be removed directly. Set a different default first, then remove the old one.

Adding a payment method​

The normal Add Payment Method button is currently hidden in the app. If you need to add a new card, contact support and Harmony can provide a secure Stripe-backed path.

When the Stripe-backed add-card flow is used, card details are entered through Stripe Elements and do not pass through Harmony servers.

Failed payments​

When Stripe cannot collect payment, Harmony can show the subscription as Past Due on Workspace Settings > Billing > Subscription.

Common reasons include:

  • Expired card.
  • Insufficient funds.
  • Bank or fraud block.
  • International transaction restrictions.
  • Incorrect or outdated payment details.

Stripe controls the retry and dunning schedule. Do not assume a fixed number of retry attempts or a specific pause/cancel date unless support has confirmed it for your workspace.

If you need a new payment method, an immediate retry, or help with an uncollectible invoice, contact support.

Tax and billing address​

Taxes and invoice details are handled through Stripe. The invoice PDF is the source of truth for tax, billing address, invoice line items, and payment confirmation.

Harmony does not currently expose a full self-serve tax, VAT, billing-address, or tax-exempt settings page. Contact support if your organization needs tax or billing-address changes.

Enterprise payment options​

Enterprise contracts can have custom payment terms, invoice handling, or billing frequency. For contract-specific payment questions, contact your account team or billing support.