> For the complete documentation index, see [llms.txt](https://docs.zeeve.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zeeve.io/zeeve-platform/manage-payment-methods.md).

# Manage Payment Methods

This guide covers day-to-day usage of payment cards in the Zeeve Platform:

* Open **Payment Methods**
* Review saved cards
* Add a new card
* Set a default card
* Delete a saved card
* Understand common errors and card states

## Open Payment Methods

1. Log in to Zeeve Platform.
2. Click on your profile icon.
3. Select **My Account** from the dropdown.
4. Open the **Payment Methods** tab.
5. Review saved cards, the default-card indicator, and the card action menu.

<figure><img src="/files/ehjbDQ1EOBd41dhlRWnu" alt=""><figcaption><p>Profile Icon</p></figcaption></figure>

<figure><img src="/files/6fkAnvnhHHuFLW8pqHkN" alt=""><figcaption><p>My Account menu item</p></figcaption></figure>

### What Data Is Shown

* **Card brand**: card network, such as Visa or Mastercard.
* **Masked card number**: only the last 4 digits are visible.
* **Card holder name**: billing name saved with the card.
* **Expiry Date**: saved card expiry in `MM/YY` format.
* **Default indicator**: check icon shown on the default payment card.
* **Settings menu**: card-level actions for setting the default or deleting a card.

Payment method changes may take a few minutes to appear on active subscriptions.

![Payment Methods tab with saved cards](/files/3978a0ad83fc6c842f1c7dd3905b50f52e07f4f3)

## Empty Cards State

If no saved cards are available, the section shows **No cards found**. The next section shows how to add a card.

![Empty Payment Methods state](/files/af098ae4a6d0f5549840d236f9bde03279b8df64)

## Add a New Card

1. Click **Add Card**.
2. Wait for the secure Stripe payment form to load.
3. Enter the card number.
4. Enter expiry and CVC.
5. Fill the billing details form.
6. **Make this the default card** for future subscription payments.
7. Click **Save Card**.
8. Verify the success message and confirm the new card appears in the list.

The card number, expiry, and CVC fields are Stripe-hosted secure fields. Raw card details are never sent directly to Zeeve servers.

![Add card Stripe form](/files/5c10d18b3ea84852f230e72fc10bfd96010ff0de)

## Billing Details

The billing details section is provided by Stripe and includes country-aware address fields.

* **Name**: card holder or billing contact name.
* **Country**: billing country list provided by Stripe.
* **Address fields**: fields may vary based on the selected country.
* **Postal code / ZIP**: required for many countries and card checks.

If Stripe marks the billing details incomplete, finish the highlighted fields before saving.

## Set Default Card

The default card is used for future subscription renewals and payment attempts.

1. Locate a non-default saved card.
2. Click the settings icon on the top-right of the card.
3. Click **Set Default**.
4. Verify that the check icon moves to the selected card.

### Default Card Notes

* Only non-default cards show **Set Default** in the settings menu.
* The current default card shows a check icon with a **Default** tooltip.
* Setting a default card does not delete or modify other saved cards.

## Delete a Saved Card

1. Locate the card you want to remove.
2. Click the settings icon on the top-right of the card.
3. Click **Delete**.
4. Review the confirmation modal.
5. Click **Remove Card** to confirm.
6. Verify the card is removed from the list.

![Remove card confirmation](/files/ad4f4d96e1c1e9528c6d0aa3fc7ffd568d4bac55)

## Action Availability

* **Default card**
  * Shows the default check icon.
  * The Settings menu includes **Delete**.
* **Non-default card**
  * The Settings menu includes **Set Default** and **Delete**.
* **While an action is running**
  * Card action buttons may be temporarily disabled.
  * Wait for the success or error message before trying again.

## Common Errors

### Card Setup Session Is Unavailable

This can happen if the add-card setup request fails or the session expires.

Recommended action:

1. Close the add-card form.
2. Click **Add Card** again.
3. Retry after the form reloads.

### Payment Form Is Still Loading

Stripe fields can take a moment to initialize.

Recommended action: wait briefly, then click **Save Card** again.

### Billing Details Are Incomplete

Stripe requires complete billing information before confirming the saved card.

Recommended action: complete all visible billing fields, especially country and postal code.

### Unable to Load Saved Cards

The card list can fail to load if the session has expired, permissions have changed, or the payment provider is temporarily unavailable.

Recommended action:

1. Click **Retry** if shown.
2. Refresh the page if the error persists.
3. Sign in again if the session has expired.

## Security Notes

* Card number, expiry, and CVC are entered through Stripe Elements.
* Zeeve stores and displays only safe card metadata, such as brand, expiry, and last 4 digits.
* Never share full card details in support tickets or screenshots.
* Use the delete action to remove cards that should no longer be used for billing.
