Skip to content

How-to

Check and repair the payment connection

Download Markdown

Open Commerce > Membership in the site admin to check a connection or payment notification problem. An Editor or Admin can check the connection. Connecting Stripe or repairing its notification setup needs an Admin. Start with an already connected account; this guide does not take a test payment.

Checked against the product’s code on 7 November 2026.

  1. Open Commerce in the site admin. The commerce screens are available to your role.
  2. Open Membership. The connection card names the connected Stripe account and its mode.
  3. Choose Check the connection. The platform asks Stripe whether the stored key still works.
  4. Read the result and its check time. An accepted key confirms that check, not a completed checkout or a delivered payment notification.
Membership shows the stored Stripe key's connection check and its saved check time.
The connection check reports the stored key result and its check time.
At phone width, Membership shows the connected test account and its saved check time.
The connection check reports the stored key result and its check time.

The check changes nothing in Stripe and does not display the secret. A connection failure is a reason to investigate, not proof that a payment succeeded or failed.

If the key must be replaced, use Stripe secret key in Membership, never a chat message. Review Connect this Stripe account to the site? and confirm Connect Stripe only for the intended account. Follow Packages and membership for the payment and access limits.

Payment notifications let Stripe tell this site about payment changes. Read Payment notifications on the same connection card before choosing a repair.

When Register payment notifications again is offered:

  1. Choose Register payment notifications again. A confirmation asks Register the payment notifications again?
  2. Review the connected account and consequence. Leave them as they are cancels the request.
  3. Confirm Register payment notifications again. Read the returned registration state.

When the card instead offers Update the Stripe notifications:

  1. Choose Update the Stripe notifications. A confirmation asks Update the Stripe notifications?
  2. Read which notification types are missing. Leave them as they are cancels the request.
  3. Confirm Update the Stripe notifications. The existing registered endpoint receives the required notification list; no second endpoint is created.
Review the notification repair before changing the connected Stripe account.

If the platform cannot read the existing endpoint, the update is refused. Follow the displayed reason rather than assuming the repair finished.

Ask Copilot to “Check this site’s Stripe connection”, then choose Send. It uses the stored key and needs no approval for the check. For a repair, ask it to register payment notifications again or update the registered notifications, according to the connection card’s reason. Each repair pauses for approval and accepts no pasted secret.

See Payment connection and Membership connection.

Checking a key has no outside change to undo. Registration and notification updates have no automatic Undo. Remove a registered endpoint through the Stripe dashboard if it should no longer send to this site. Review that decision carefully, because the site relies on those notifications for payment state.

Return to Commerce > Membership and read the latest connection result and Payment notifications. Follow Check selling readiness before offering paid access.