> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fusioncore.us/llms.txt
> Use this file to discover all available pages before exploring further.

# Editing Wallet Items

> Rename a saved payment method or replace its details, as a Staff user in Commerce or as a portal user on the My Wallet page.

You can update a Wallet Item to change its nickname or to replace the underlying payment details. Renaming is a simple in-place edit. Changing anything beyond the nickname does not modify the existing method — fusionCore retires the old Wallet Item and creates a new one, because the payment details on the original cannot be altered in Stripe.

Staff edit Wallet Items directly in Commerce from the contact's **Wallet** action. Portal users edit their own through the **fusionCore: Wallet Items** component on the **My Wallet** page; both use the same Commerce wallet UI.

<Info>
  When you change any detail other than the nickname, the original Wallet Item is retired and a new one is created in its place.
</Info>

## Editing a Wallet Item as a Staff User

<Steps>
  <Step title="Open the contact's wallet">
    On a Contact record, click the **Wallet** action.

    <Frame>
      <img src="https://mintcdn.com/fusionspan/dgaf-BkijdfqhSNr/images/end-user-guides/4859363536/image-20250519-170832.png?fit=max&auto=format&n=dgaf-BkijdfqhSNr&q=85&s=4109c165325fef17db072a7149238720" alt="A Contact record with the Wallet action highlighted" width="1891" height="857" data-path="images/end-user-guides/4859363536/image-20250519-170832.png" />
    </Frame>
  </Step>

  <Step title="Edit the Wallet Item">
    On the wallet view, click the **pencil icon** for the Wallet Item you want to edit.

    <Frame>
      <img src="https://mintcdn.com/fusionspan/dgaf-BkijdfqhSNr/images/end-user-guides/4859363536/image-20250605-174015.png?fit=max&auto=format&n=dgaf-BkijdfqhSNr&q=85&s=46cd7f6a5645f631f49797826cd472f6" alt="The wallet view with the pencil edit icon on a Wallet Item" width="1917" height="732" data-path="images/end-user-guides/4859363536/image-20250605-174015.png" />
    </Frame>

    To change only the nickname, edit that field and click **Save**.

    <Frame>
      <img src="https://mintcdn.com/fusionspan/dgaf-BkijdfqhSNr/images/end-user-guides/4859363536/image-20250605-174056.png?fit=max&auto=format&n=dgaf-BkijdfqhSNr&q=85&s=2165cff22ff469034a7ce9e37da171de" alt="Editing the nickname of a Wallet Item" width="1595" height="684" data-path="images/end-user-guides/4859363536/image-20250605-174056.png" />
    </Frame>

    To change other details, click **Edit**, make your changes, then click **Save**. This retires the old Wallet Item and creates a new one.

    <Frame>
      <img src="https://mintcdn.com/fusionspan/dgaf-BkijdfqhSNr/images/end-user-guides/4859363536/image-20250519-172404.png?fit=max&auto=format&n=dgaf-BkijdfqhSNr&q=85&s=0ce1ba0ada490994783795d864cfdf31" alt="Editing the full payment details of a Wallet Item" width="983" height="591" data-path="images/end-user-guides/4859363536/image-20250519-172404.png" />
    </Frame>
  </Step>
</Steps>

## Editing a Wallet Item as a Portal User

<Steps>
  <Step title="Open My Wallet">
    In the Portal, navigate to the **My Wallet** tab.
  </Step>

  <Step title="Edit the Wallet Item">
    On the wallet view, click the **pencil icon** for the Wallet Item you want to edit.

    <Frame>
      <img src="https://mintcdn.com/fusionspan/dgaf-BkijdfqhSNr/images/end-user-guides/4859363536/Screenshot_2025-05-19_at_12.36.33-PM.png?fit=max&auto=format&n=dgaf-BkijdfqhSNr&q=85&s=884c00094e167a5f93488eb82750eeaf" alt="The My Wallet view with the pencil edit icon on a Wallet Item" width="1540" height="705" data-path="images/end-user-guides/4859363536/Screenshot_2025-05-19_at_12.36.33-PM.png" />
    </Frame>

    To change only the nickname, edit that field and click **Save**.

    <Frame>
      <img src="https://mintcdn.com/fusionspan/dgaf-BkijdfqhSNr/images/end-user-guides/4859363536/image-20250519-173931.png?fit=max&auto=format&n=dgaf-BkijdfqhSNr&q=85&s=ed2cc508e1522a86119f42e21633777c" alt="Editing the nickname of a Wallet Item in the Portal" width="1173" height="658" data-path="images/end-user-guides/4859363536/image-20250519-173931.png" />
    </Frame>

    To change other details, click **Edit**, make your changes, then click **Save**. This retires the old Wallet Item and creates a new one.
  </Step>
</Steps>

## Limitations and Common Pitfalls

* **Changing details replaces the method.** Only the nickname can be edited in place. Any other change retires the original Wallet Item and creates a new one, because the stored payment details cannot be altered at the provider. Expect the old entry to disappear from the active list.
* **Removed Wallet Items are not hard-deleted.** When a Wallet Item is removed, fusionCore soft-deletes it (it sets `Is_Removed__c`, `Removal_Date__c`, and `Removal_Reason__c`) rather than deleting the record. The record persists for audit and reporting even though it no longer appears in the wallet.
* **Removal detaches the method in Stripe.** Removing a Wallet Item fires the Stripe removal handler, which detaches the method on the provider side. Once removed, the method can no longer be used to pay and cannot be reactivated — save a new one instead.
