> 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.
Profile Icon
My Account menu item
### 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.
## Empty Cards State
If no saved cards are available, the section shows **No cards found**. The next section shows how to add a card.
## 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.
## 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.
## 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.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.zeeve.io/zeeve-platform/manage-payment-methods.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.