Manage payment methods

Manage saved cards from Settings → Team → Billing: list cards, add a card (SetupIntent), set default, remove. Wevion is card-only; Stripe holds the card data.

Written By Salvatore Sinigaglia

Last updated About 4 hours ago

Manage saved cards from Settings → Team → Billing: list cards, add a card (SetupIntent), set default, remove. Wevion is card-only; Stripe holds the card data.

Manage payment methods

Wevion has native payment-method endpoints for saved cards: list them, add a new one via a Stripe SetupIntent, set a default, and remove one — all from Settings → Team → Billing (/api/v1/billing/payment-methods). The setup collects card methods only (SEPA is not offered in-app). You can also open the Stripe Customer Portal ("Manage billing in Stripe") for billing details and invoice history. Wevion never stores card numbers — Stripe holds the card data.

Who is this for

Owners and admins updating payment info for the workspace. Finance users may view billing data where permitted, but payment-method writes should be verified against current RBAC before documenting them as available. Common reasons: card expired, switched bank, new corporate card.

Before you start

  • Owner or admin role with billing permission
  • The new card ready (Wevion collects card payment methods; SEPA is not offered in-app)
  • For the Stripe Customer Portal path: a browser allowing the hosted page (some strict ad-blockers may block — disable for billing.stripe.com)

Managing cards natively in Wevion (card-only)

Wevion exposes its own card management, so you don't have to leave the app for the common cases:

  • List cards: GET /api/v1/billing/payment-methods — returns your saved cards, each flagged with default state and a validity status (valid / expired / expiring_soon)
  • Add a card: POST /api/v1/billing/payment-methods/setup-intent creates a Stripe SetupIntent with payment_method_types: ['card'] — you enter the card, Stripe saves it off-session
  • Set default: POST /api/v1/billing/payment-methods/:id/default
  • Remove a card: DELETE /api/v1/billing/payment-methods/:id

Because the SetupIntent is card-only, SEPA Direct Debit is not available in-app. Wevion is effectively card-only for self-serve billing.

How to access the Stripe Customer Portal

Step 1: Open the billing page

Navigate to Settings → Team → Billing in Wevion.

Step 2: Click "Manage billing in Stripe"

The button is typically at the top of the billing page or under a Payment methods section. Behind the scenes: POST /api/v1/billing/portal generates a one-time secure URL.

Step 3: You land on the Stripe-hosted portal

The portal shows:

  • Your current default payment method
  • Payment history (links to receipts and invoices)
  • Subscription status
  • Buttons to update card, add new method, change billing address, cancel subscription

This page is hosted by Stripe under billing.stripe.com — you're temporarily authenticated via the URL Wevion generated.

Step 4: Make your changes

  • Update card: click on the card → enter new number, CVC, expiry, ZIP
  • Add new method: click Add payment method → enter a card → fill details (Wevion collects card methods)
  • Set as default: each method has a "Make default" action
  • Remove method: only allowed if not the only payment method on file

Stripe applies changes immediately. The next charge uses the default method.

Supported payment types

MethodRegionNotes
Credit / debit card (Visa, Mastercard, Amex)GlobalThe only self-serve method. 3DS / SCA challenge enforced for EU and other strong-customer-authentication regions
Bank transfer (wire)Enterprise / large invoicesCustom-arranged via Sales, outside the self-serve flow

Wevion's self-serve payment collection is card-only — SEPA Direct Debit is not offered in-app (the SetupIntent and checkout collect card methods only). Apple Pay / Google Pay may appear on the Stripe-hosted pages depending on device but are card-backed methods.

Currency

Stripe charges in the currency you signed up with (typically USD or EUR depending on region). Currency cannot be changed post-signup through the portal — contact Sales for currency change, which requires creating a new subscription.

3DS / SCA (Strong Customer Authentication)

For European cards, your bank may require a 3DS challenge (SMS code, biometric, app prompt) on the first charge of a new card. If you miss the challenge, the charge fails — Stripe Smart Retries will try again.

If you frequently get 3DS challenges:

  • Add the new card during a low-traffic moment so you're ready for the prompt
  • Use a corporate card pre-authorized for the merchant

What you'll see

After updating a payment method:

  • Stripe Portal shows the new method as default (if you set it so)
  • An email confirmation from Stripe
  • Wevion's /settings/team/billing updates within 30-60s (webhook sync)
  • Next renewal charge uses the new method

Common issues

  • Portal won't open / URL expired: portal URLs are short-lived. Click Manage billing in Stripe again to get a fresh URL.
  • "Card requires 3DS" during update: complete the bank prompt. If prompt didn't appear, your browser may have blocked the popup — allow popups for billing.stripe.com and retry.
  • Old card kept getting charged after I added a new one: you added but didn't set as default. Edit and choose Make default.
  • Cannot delete the only payment method: add a new one first, then delete the old.
  • Charges in wrong currency after switching country: Stripe ties currency to the original subscription. To change, cancel and resubscribe under the new currency (lose any prepaid balance) or contact Sales.

Security

Wevion never sees your card number or CVC. Stripe is PCI-DSS Level 1 certified. All payment data is handled by Stripe's secure infrastructure. Wevion stores only the Stripe customer ID and a reference to which payment method is default — never the actual numbers.

FAQ

How do I update my card in Wevion?

You can manage cards natively in Wevion from Settings → Team → Billing: list saved cards, add a new one via a Stripe SetupIntent (POST /api/v1/billing/payment-methods/setup-intent), set a default, or remove one. You can also use the Stripe Customer Portal ("Manage billing in Stripe") for the same. Stripe applies changes immediately and the next charge uses the default card.

Does Wevion store my card number?

No. Wevion never sees your card number or CVC. All payment data is handled by Stripe's PCI-DSS Level 1 certified infrastructure. Wevion stores only the Stripe customer ID and a reference to which payment method is set as default — never the actual numbers.

Can I pay by SEPA Direct Debit instead of card?

No — Wevion's self-serve payment collection is card-only. The add-payment-method flow creates a Stripe SetupIntent with payment_method_types: ['card'], and checkout collects a card, so SEPA Direct Debit isn't offered in-app. Use a credit or debit card.

Why does my card get a 3DS challenge on the first charge?

For European cards, Strong Customer Authentication (SCA) can require a 3DS prompt — an SMS code, biometric, or app confirmation — on the first charge of a new card. If you miss it the charge fails, but Stripe Smart Retries will try again. To reduce repeat challenges, use a corporate card pre-authorized for recurring merchants.

Why can't I delete my payment method?

Stripe only lets you remove a payment method if it is not the only one on file. Add a new card first, then delete the old one. If a removed-but-unset card keeps getting charged, set the intended card as default via Make default.