Payment Methods
What This Is
Payment Methods is the shopper-facing My Account page where a customer can review saved cards, choose a default card, or remove a saved card.
In the shared package, this is a real packaged page, but it focuses on managing existing cards rather than onboarding a new card directly on the page.
When You Would Use It
Use Payment Methods when you need to:
- review the cards already saved for a customer account
- set the default saved card
- delete a card that should no longer be used
- confirm which card will be easiest to use for future payment collection
Before You Start
Before you use this page, make sure:
- the customer is logged in
- the customer already has at least one saved card
- your project has already provided a card-session or saved-card onboarding path
The shared package page itself does not expose a visible “add new card” form in the repo inspected in this pass. Card onboarding depends on gateway-backed session flows.
How To Use It In The Storefront
- Go to
My Account > Payment Methods. - Review the saved cards shown on the page.
- Check:
- card brand
- last four digits
- expiration date
- which card is marked as default
- Use
Make defaultwhen you want a different saved card to become the default. - Use
Deletewhen a card should no longer be available.
What It Changes In The Storefront
Payment Methods changes which saved cards are available for future payment collection and which card is treated as the default card.
It does not itself create an order payment or settle an amount due.
Common Tasks
Pick the default card
Mark the card your team should use most often as the default so later saved-card payment flows are simpler.
Remove an expired or unwanted card
Delete the card from the saved-card list when it should no longer be used.
Confirm whether a customer already has a saved card
Use this page before attempting a saved-card charge workflow on an order.
Rules, Limits, And Things To Watch
- This page manages existing cards only in the shared package inspected here.
- Payment methods and order payments are different concepts.
- Saved cards depend on gateway support, especially Stripe-backed card flows in the shared package.
Troubleshooting
There is no way to add a card on the page
That is expected in the shared package inspected in this pass. Card onboarding depends on a separate card-session flow.
The wrong card is used later
Check which card is marked as default.
The customer cannot see any payment methods
Check whether the customer has actually completed the saved-card onboarding flow for the configured gateway.
Related Features
- Payments
- Invoices
- Orders
Sources
packages/storefront/routes/web.phppackages/storefront/src/Livewire/Storefront/MyAccount/PaymentMethods/Page.phppackages/storefront/src/Livewire/Storefront/MyAccount/PaymentMethods/Table.phppackages/storefront/resources/views/components/my-account/payment-methods/table.blade.phppackages/framework/src/Models/Customer.php