---
title: "Stripe Payment"
description: "The Stripe plugin lets your customers pay using credit cards, digital wallets, bank transfers, and buy-now-pay-later options — all processed securely..."
url: "https://docs.j2commerce.com/v6/payment-methods/payment_stripe"
markdown_url: "https://docs.j2commerce.com/v6/payment-methods/payment_stripe.md"
last_updated: "2026-11-06T15:02:13+00:00"
version: "J2Commerce 6"
breadcrumbs:
  - title: "Home"
    url: "https://docs.j2commerce.com/"
  - title: "J2Commerce 6"
    url: "https://docs.j2commerce.com/v6"
  - title: "Payment Methods"
    url: "https://docs.j2commerce.com/v6/payment-methods"
  - title: "Stripe Payment"
    url: "https://docs.j2commerce.com/v6/payment-methods/payment_stripe"
---

# Stripe Payment

The Stripe plugin lets your customers pay using credit cards, digital wallets, bank transfers, and buy-now-pay-later options — all processed securely through Stripe's payment platform.

Choose between two checkout experiences: **Embedded** (payment form displayed directly on your checkout page) or **Hosted** (redirect to a Stripe-hosted payment page). Both support refunds, webhooks for automatic order updates, and saved cards for returning customers.

## Prerequisites

- J2Commerce 6.6.6 or later is installed and active on your Joomla site
- A Stripe account (see the setup steps below)
- API keys from your Stripe Dashboard (Publishable Key and Secret Key)

## Set Up a Stripe Account

If you already have a Stripe account and API keys, skip ahead to [Installation & Enabling](https://docs.j2commerce.com/v6/payment-methods/payment_stripe#installation--enabling).

### Create a Stripe Account

1. Go to [stripe.com](https://stripe.com) and click **Sign up**.
2. Enter your email address and create a password.
3. Verify your email address when Stripe sends you a confirmation email.
4. Complete the identity verification steps Stripe requires (this varies by country).
5. Activate your account by providing business details and bank account information.

### Get Your API Keys

After your account is active:

1. Log in to the [Stripe Dashboard](https://dashboard.stripe.com).
2. Click **Developers** in the left sidebar, then **API Keys**.
3. You will see your **Publishable key** and **Secret key**.
4. Copy both keys and keep them somewhere safe.

> **Tip:** **IMPORTANT**: **Use Sandbox (Test Mode):** Toggle the **Test mode** switch at the top of the Stripe Dashboard. The API keys shown will be for testing — no real money is processed. Copy the test Publishable key and test Secret key separately.

## Purchase and Download

This plugin is a separate add-on available from the **J2Commerce Extensions Store**. It does not come with the core J2Commerce 6 component.

**Step 1:** Go to our [**J2Commerce**](https://www.j2commerce.com/extensions) website **->** **Payment Plugin**

**Step 2:** Locate the **Payment_Stripe** Plugin **->** click **View Details** **->** **Add to cart** **->** **Checkout**.

**Step 3:** Go to your **My Download**s under your profile button at the top right corner and search for the app. Click **Available Versions -> View Files -> Download Now**

## Installing the Plugin

You can install the **Stripe** Payment plugin using the Joomla installer. The following steps help you with a successful installation.

In the Joomla admin, go to **System -> Install -> Extensions**

1. Upload the **Payment_Stripe** ZIP file or use the Install from URL option.

   ![Joomla System Dashboard with System in the sidebar and the Install section's Extensions link highlighted, used to upload a plugin package](https://docs.j2commerce.com/images/docs/shared/autho-install5.webp)

## Enable the Plugin

Once you have installed the extension, you will need to enable it. There are **two** ways you can access the extension.

**Option A:** Go to the **J2Commerce** icon at the top right corner **-> Setup -> Payment Methods**

**Option B:** Go to **Components** on the left sidebar **-> J2Commerce -> Dashboard -> Setup -> Payment Methods**

![Payment Methods list with a 1 item(s) published message, opened through Components and the J2Commerce menu: Setup and Payment Methods highlighted](https://docs.j2commerce.com/images/docs/shared/autho-methods.webp)

Look for **Stripe**, click the **X,** and it will turn into a green checkmark. It is now enabled and ready for setup.

![Payment Methods list with the Stripe plugin's enabled status check highlighted; PayPal shows disabled, other methods enabled, with the J2Commerce menu at left](https://docs.j2commerce.com/images/docs/shared/stripe-enable2.webp)

## Configuring the Plugin

After enabling the plugin, click the **Stripe Payment** title to open the settings.

> **Tip:** **Tip**: Click on the **Toggle Inline Help** button on any app/plugin you install and it will show a description below each section. See image below

![Plugins: Stripe settings with the Toggle Inline Help button highlighted and the Display Name help text shown; Status Enabled, Access Public](https://docs.j2commerce.com/images/docs/shared/stripe-toggle.webp)

### Display Settings

![Plugins: Stripe settings, Plugin tab: Display Name Credit / Debit Card, Stripe logo as Display Image, Status Enabled, Access Public, Ordering Easy Reorder](https://docs.j2commerce.com/images/docs/shared/stripe-config.webp)

**Display Name:** The label shown to customers at checkout

**Display Image:** Optional logo or image shown next to the payment option at checkout

### Checkout Mode

![Stripe plugin Checkout Mode settings: Checkout Mode Embedded (Stripe Elements), Element Type Payment Element (all methods), Capture Method Automatic (charge immediately)](https://docs.j2commerce.com/images/docs/shared/stripe-config1.webp)

Choose how customers interact with the payment form:

**Checkout Mode:** How the payment form is displayed

- **Embedded:** Payment form loads directly on your checkout page. Customers never leave your site. Choose between Payment Element (recommended) or Card Element.
- **Hosted:** Customers are redirected to a Stripe-hosted payment page. After completing payment, they are redirected back to your site.

### Element Type (Embedded Mode Only)

This setting appears when **Checkout Mode** is set to **Embedded**.

**Element Type:** Which Stripe UI element to use

- **Payment Element:** Full payment method selection. Stripe shows relevant payment methods based on the customer's location. **Recommended.**
- **Card Element:** Simple card form. Use this if you want a minimalist credit card input without additional payment method options.

### Payment Methods (Card Element Only)

When **Element Type** is set to **Card**, you can enable additional payment methods beyond credit cards:

> **Info:** **Note**: Some payment methods require activation in your Stripe Dashboard. See [Enable Payment Methods in Stripe](https://docs.j2commerce.com/v6/payment-methods/payment_stripe#enable-payment-methods-in-stripe-dashboard) below.

| Payment Method | Description |
| --- | --- |
| **Card** | Credit and debit cards (Visa, Mastercard, Amex, etc.) |
| **Amazon Pay** | Pay with Amazon account |
| **PayPal** | Pay with PayPal |
| **Link** | Stripe Link one-click checkout |
| **Cash App** | Pay with Cash App |
| **Affirm** | Buy now, pay later (US) |
| **Afterpay/Clearpay** | Buy now, pay later (varies by region) |
| **Klarna** | Buy now, pay later |
| **Zip** | Buy now, pay later |
| **Revolut Pay** | Pay with Revolut |
| **iDEAL** | Bank transfer (Netherlands) |
| **Bancontact** | Bank transfer (Belgium) |
| **SEPA Direct Debit** | Bank transfer (Europe) |
| **giropay** | Bank transfer (Germany) |
| **Sofort** | Bank transfer (Europe) |
| **EPS** | Bank transfer (Austria) |
| **Przelewy24 (P24)** | Bank transfer (Poland) |
| **BLIK** | Mobile payment (Poland) |
| **GrabPay** | Mobile wallet (Southeast Asia) |
| **FPX** | Bank transfer (Malaysia) |
| **Alipay** | Mobile wallet (China) |
| **WeChat Pay** | Mobile wallet (China) |
| **Pix** | Bank transfer (Brazil) |
| **Boleto** | Bank transfer (Brazil) |
| **OXXO** | Cash payment (Mexico) |
| **ACH Direct Debit** | Bank transfer (US) |

### Capture Method

Choose when to capture payment:

**Capture Method:** When payment is captured from the customer's account

**Automatic:** Payment is captured immediately when the customer completes checkout. The order status updates to Confirmed right away.

**Manual:** Payment is authorized but not captured. You must manually capture the payment from the order admin page. Use this for pre-orders, backorders, or when you need to verify stock before charging.

### Sandbox Mode

![Stripe plugin sandbox settings: Use Sandbox (Test Mode) Yes, Sandbox Publishable Key, Secret Key and Webhook Secret fields (values hidden), plus the webhook URL copy box](https://docs.j2commerce.com/images/docs/shared/stripe-config2.webp)

**Sandbox:** Switch on to use Stripe's test environment. No real money is processed.

Turn sandbox mode **on** while you are setting up and testing. Turn it **off** before you go live.

> **Info:** **Note**: When sandbox mode is active, a warning banner appears on the J2Commerce dashboard so you cannot accidentally forget.

### Live API Credentials

These are used when **Sandbox** is set to **No**.

**Publishable Key:** Your live Publishable key from the Stripe Dashboard

**Secret Key:** Your live Secret key from the Stripe Dashboard

**Webhook Secret:** Your live Webhook signing secret (see Webhooks below)

### Sandbox API Credentials

These are used when **Sandbox** is set to **Yes**.

**Sandbox Publishable Key:** Your test Publishable key

**Sandbox Secret Key:** Your test Secret key

**Sandbox Webhook Secret:** Your test Webhook signing secret

### Webhooks

Webhooks allow Stripe to notify your store automatically when payment events occur — captures, refunds, disputes, and more. Without webhooks, order status updates only happen during the normal checkout flow.

A **Webhook URL** field is displayed in the plugin settings — copy this URL and register it in your Stripe Dashboard.

**Webhook URL (Live):** The URL to register in your live Stripe Dashboard

**Webhook URL (Sandbox):** The URL to register in your test Stripe Dashboard

**How to create a webhook in Stripe:**

1. In the Stripe Dashboard, go to **Developers** **->** **Webhooks**.
2. Click **Add endpoint**.
3. Paste the **Webhook URL** from the J2Commerce plugin settings.
4. Select the events to listen for. Recommended events:

| Event | What happens in J2Commerce |
| --- | --- |
| `payment_intent.succeeded` | Order status updated to Confirmed |
| `payment_intent.payment_failed` | Order status updated to Failed |
| `payment_intent.canceled` | Order status updated to Canceled |
| `charge.refunded` | Order status updated to Refunded |
| `charge.dispute.created` | Warning logged for review |
| `checkout.session.completed` | Order status updated (for Hosted mode) |

1. Click **Add endpoint**.
2. On the next page, click **Reveal** next to **Signing secret**.
3. Copy the signing secret (starts with `whsec_...`).
4. Paste it into the **Webhook Secret** field in the J2Commerce plugin settings.

### Saved Cards

![Stripe plugin saved card settings: Allow Saved Cards Yes, Enable Link Yes, Template Style Default](https://docs.j2commerce.com/images/docs/shared/stripe-config3.webp)

**Allow Saved Cards:** Let logged-in customers save cards for faster checkout on future orders

When enabled, customers see a **Save card for future purchases** checkbox at checkout. Saved cards appear in the customer's profile under **My Account** -> **Payment Methods**.

**Enable Link:** Enable Stripe Link (one-click checkout with saved addresses/payment methods). Only available with Payment Element.

Stripe Link lets customers who have saved payment details with Stripe Link pay with a single click using their email address. This requires **Allow Saved Cards** to be enabled.

**Template Style:** Choose the frontend template layout for checkout forms and saved card displays. Options depend on your site's template framework.

Available subtemplates: **Bootstrap 5** and **UIkit**. Leave blank to use the default layout. If your Joomla template is UIkit-based (e.g., YOOtheme Pro), select the UIkit subtemplate for consistent styling.

### Order Status

![Stripe plugin order status settings: Order Status Confirmed, Change Order Status on Refund Yes with Refunded, Change Order Status on Void Yes with Cancelled](https://docs.j2commerce.com/images/docs/shared/stripe-config4.webp)

**Order Status:** The order status applied after a successful payment

Choose the status that fits your workflow. Most stores use **Confirmed** or **Processing** for paid orders.

> **Info:** NOTE: If the status you want isn't listed in the dropdown menu, you can create a new one by going to **J2Commerce -> Setup -> Order Statuses**

![J2Commerce Order Statuses list with the J2Commerce menu open at the right, highlighting Setup and its Order Statuses item](https://docs.j2commerce.com/images/docs/shared/shipstation-order-status2-1.webp)

### Refund Settings

**Order Status on Refund:**

- When set to '**No**', the order status is automatically changed when a refund is processed.
- When set to '**Yes**', the order status to set when a refund is processed. A common choice is Refunded or Canceled.

**Refund Order Status:** The status to set when a full refund is processed (shown when Change Status on Refund is )

**Partial Refund Order Status:** The status to set when a partial refund is processed (shown when Change Status on Refund is '**Yes**')

### Void Settings

**Change Status on Void:** Automatically change the order status when an authorized payment is voided

**Void Order Status:** The status to set when a void is processed (shown when Change Status on Void is '**Yes**')

### Order Status View

> **Info:** **Note**: The order status will only change to Refunded if it is a **Full refund**. If it is a Partial Refund, the status will stay the same

![Orders list with the Stripe order's Status badge highlighted as Refunded and the status dropdown in Actions set to Refunded, beside a Confirmed Kustom Payment order](https://docs.j2commerce.com/images/docs/shared/stripe-refund3.webp)

### Surcharge

![Stripe plugin surcharge settings: empty Surcharge Name, Surcharge Percent, Surcharge Fixed fields and an empty Surcharge Tax Class dropdown](https://docs.j2commerce.com/images/docs/shared/stripe-config5.webp)

Add an optional surcharge to orders paid via Stripe. This is useful if you want to pass on Stripe's processing fee to customers (check your local laws and Stripe's terms before doing this).

**Surcharge Name:** Label shown to customers for the surcharge (e.g., "Processing Fee")

**Surcharge Percent:** Percentage of the order subtotal added as a surcharge

**Surcharge Fixed:** Fixed amount added as a surcharge

**Surcharge Tax Class:** Tax profile to apply to the surcharge amount

You can combine a percentage and a fixed amount — both will be added together.

### Geo-Zone Restriction & Subtotals

![Stripe plugin restriction settings: Geozone Restriction multi-select, Minimum Subtotal and Maximum Subtotal fields, and Statement Descriptor field, all empty](https://docs.j2commerce.com/images/docs/shared/stripe-config6.webp)

**Geo-Zone Restriction:** Limit Stripe availability to customers in a specific geo-zone

> **Info:** **Note**: Leave this empty to show Stripe to all customers regardless of location.

**Minimum Subtotal:** Hide Stripe if the cart subtotal is below this amount. Leave empty for no minimum.

**Maximum Subtotal:** Hide Stripe if the cart subtotal exceeds this amount. Leave empty for `-1` for no maximum.

**Statement Descriptor:** Text that appears on your customers' bank statements (max 22 characters)

If empty, Stripe uses your account's default statement descriptor.

### Thank You Page & Custom Messages

![Stripe plugin message settings: Thank You Article selector, five message text boxes (On Selection through Order Cancelled), Show Dashboard Icon No, Debug Mode No](https://docs.j2commerce.com/images/docs/shared/stripe-config7.webp)

**Thank You Article:** Select a Joomla article to display after a successful payment. This is shown on the confirmation page in addition to the standard confirmation message.

### Custom Messages

These text fields let you customize messages shown to customers at different points in the payment process.

**On Selection:** It displays when the customer selects Stripe as their payment method

**On Before Payment:** It displays on the payment page before the customer clicks Pay

**On After Payment:** It displays on the confirmation page after a successful payment

**On Error Payment:** It displays when a payment error occurs

**On Cancel Payment:** It displays when the customer cancels payment and returns to the cart

### Dashboard Icon

**Show Dashboard Icon:** When enabled, this plugin adds an icon tile to the J2Commerce dashboard and the J2Commerce quick icons module.

**Icon Label:** Label for the dashboard icon (only visible when Show Dashboard Icon is '**Yes**')

**Debug Mode:** Write detailed Stripe API activity to `administrator/logs/payment_stripe.php` and the browser console

> **Tip:** **Tip**: Enable debug mode only while troubleshooting. Disable it in production — logs can grow large quickly.

### Agentic Commerce

The **Agentic Commerce** tab lets AI shopping agents pay through Stripe. It works only when the separate Agentic Commerce app is installed. All three options are off by default.

| Setting | What It Does | Default | Options |
| --- | --- | --- | --- |
| **Offer Google Pay to Agents** | Agents such as Google AI Mode can pay with a Google Pay token that Stripe charges. | No | Yes, No |
| **Offer Stripe Shared Payment Tokens** | Agents that hold a Stripe shared payment token can pay with it. Requires your Stripe business profile ID. | No | Yes, No |
| **Stripe Business Profile ID** | The `profile_...` ID from your Stripe Dashboard that agents use to issue shared payment tokens for this store. Shown when Offer Stripe Shared Payment Tokens is Yes. | Empty | Text starting with `profile_` |

Each option is offered to agents only while the Stripe API keys for the current mode (live or sandbox) are set.

To offer Google Pay, set the Google Pay environment in the Agentic Commerce app to match the Stripe mode: **Test** for sandbox, **Production** for live. In live mode, also set the app's Google Pay merchant ID.

> **Info:** Agent charges always use the order total and currency stored on the order. The Agentic Commerce app settles agent payments, not the Stripe order webhooks.

---

## Enable Payment Methods in Stripe Dashboard

Some payment methods in Stripe require activation before they appear at checkout:

1. Log in to the [Stripe Dashboard](https://dashboard.stripe.com).
2. Go to **Settings** -> **Payment methods**.
3. Click **Add payment methods** or enable individual methods.
4. For each payment method you want to use:
   - Click the method name (e.g., **Klarna**, **Affirm**).
   - Toggle **On** to enable it.
   - Some methods require additional verification or configuration — follow the prompts.

> **Tip:** **Important:** Payment methods are shown based on the customer's location and currency. A customer in the US won't see iDEAL (Netherlands-only) even if it's enabled.

![Checkout Payment Method section with the Stripe payment element highlighted: tabs for Card (selected), Cash App Pay, Amazon Pay and Klarna above the card number field](https://docs.j2commerce.com/images/docs/shared/stripe-checkout5.webp)

---

## Checkout Experience

![Checkout Payment Method list with Credit / Debit Card (Stripe logo) selected and highlighted, among Cash on Delivery, Money Order / Check, Bank Transfer, Credit Card and Kustom Pay](https://docs.j2commerce.com/images/docs/shared/stripe-checkout2.webp)

### Embedded Mode (Payment Element)

![Stripe plugin settings: Checkout Mode Embedded (Stripe Elements), Element Type Payment Element (all methods), Capture Method Automatic (charge immediately)](https://docs.j2commerce.com/images/docs/shared/8stripe-checkout-automatic-payment-embedded2.webp)

When a customer selects Stripe at checkout:

1. The Payment Element loads directly on your checkout page.
2. The customer sees payment methods relevant to their location and currency.
3. They enter payment details and click **Pay**. or **Use This Card**, if they have a card saved.
4. The payment is processed without leaving your site.
5. The customer sees the confirmation page.

**Checkout View**

![Storefront checkout Confirm Order step with Stripe: Saved Payment Methods (Visa 4242), Use a new card selected, Link card panel, and the Place Order button](https://docs.j2commerce.com/images/docs/shared/8stripe-checkout-automatic-payment-embedded1.webp)

### Embedded Mode (Card Element)

When Element Type is set to Card:

- A simple card form appears with optional payment method buttons.
- The customer enters card details or clicks an alternative payment method.
- Payment is processed without leaving your site.

## Frontend View for each Checkout option (Embedded)

### Embedded -> Card Element -> Manual

**Plugin Settings**

![Stripe plugin settings: Checkout Mode Embedded (Stripe Elements), Element Type Card Element (cards only), Capture Method Manual (authorise only)](https://docs.j2commerce.com/images/docs/shared/8stripe-checkout-manual-embedded1.webp)

**Frontend View**

![Storefront checkout with Stripe selected: a single Card number field with a Link Visa 4242 badge above the Place Order button, order total 6.75](https://docs.j2commerce.com/images/docs/shared/8stripe-checkout-manual-embedded.webp)

### Embedded -> Card Element -> Automatic

**Plugin Settings**

**Frontend View**

### Embedded -> Payment Element -> Automatic

**Plugin Settings**

![Stripe plugin settings: Checkout Mode Embedded (Stripe Elements), Element Type Payment Element (all methods), Capture Method Automatic (charge immediately)](https://docs.j2commerce.com/images/docs/shared/8stripe-checkout-automatic-payment-embedded2.png)

**Frontend View**

![Storefront checkout Confirm Order step with Stripe: Saved Payment Methods (Visa 4242), Use a new card selected, Link card panel, and the Place Order button](https://docs.j2commerce.com/images/docs/shared/8stripe-checkout-automatic-payment-embedded1-1.webp)

### Embedded -> Payment Element -> Manual

**Plugin Settings**

![Stripe plugin settings: Checkout Mode Embedded (Stripe Elements), Element Type Payment Element (all methods), Capture Method Manual (authorise only)](https://docs.j2commerce.com/images/docs/shared/8stripe-checkout-manual-payment-embedded1.webp)

**Frontend View**

![Storefront checkout with Stripe: saved Visa 4242 and Use a new card selected, Link panel with Visa Credit, card-storage consent note, and Place Order](https://docs.j2commerce.com/images/docs/shared/8stripe-checkout-manual-payment-embedded2.webp)

### Hosted Mode

When Checkout Mode is set to Hosted:

- The customer is redirected to a Stripe-hosted payment page.

![Confirm Order step with Stripe Link showing a saved Visa ending in 4242, a Use this card button and a Place Order button, order total $6.75](https://docs.j2commerce.com/images/docs/shared/stripe-checkout6.webp)

- They complete payment on Stripe's secure servers.

![Stripe Link verification page in Test Mode for a $6.75 order: Confirm it's you with a six-digit code entry, Send code to email instead and Pay without Link options](https://docs.j2commerce.com/images/docs/shared/stripe-checkout-hosted7.webp)

- After payment, they are redirected back to your confirmation page

  ![Stripe-hosted payment page in test mode for a 6.75 order: Link panel with Pay with Visa 4242, billing details, a green Pay button and Pay without Link](https://docs.j2commerce.com/images/docs/shared/8stripe-checkout-hosted8.webp)

## Order Management

Once a customer pays, J2Commerce records the transaction details:

- **Order status** is updated to the status you configured (default: Confirmed).
- **Transaction ID** — the Stripe Payment Intent ID — is stored with the order.
- **Transaction status** — Completed, Authorized, or Partially Refunded — is tracked.
- **Order history** is updated with a "Payment received via Stripe" note.

![Order History timeline for a Stripe order: charged, status Confirmed, partial refund of $3.00, full refund of remaining amount, then status Refunded](https://docs.j2commerce.com/images/docs/shared/stripe-refund4.webp)

### Capture Authorized Payments (Manual Capture)

If you set **Capture Method** to **Manual**, payments are authorized but not captured. To capture:

1. Go to **J2Commerce** -> **Orders** and open the order.
2. Look for the **Payment** section on the order view page.
3. Click **Capture** to capture the authorized amount.
4. The order status updates to Confirmed.

You can also **Void** an authorization to cancel it without charging the customer.

### Refunds

You can issue a refund directly from the order in the J2Commerce admin:

- Go to **J2Commerce ->** **Orders** and open the order.
- Look for the **Payment** section.
- Click **Refund**.

![Order screen for a Stripe order: Order Details row with Stripe logo and the Refund button highlighted next to View Details, above the customer panel](https://docs.j2commerce.com/images/docs/shared/stripe-refund5.webp)

- Enter the amount to refund (leave blank to refund the full amount).
- Confirm the refund.

The refund is sent to Stripe via the API. If you enabled **Change Status on Refund**, the order status updates automatically.

![Refund Order dialog with the Full refund $6.75 and Partial refund options highlighted, Partial selected, Refund Amount 3.00 and Process Refund button](https://docs.j2commerce.com/images/docs/shared/stripe-refund.webp)

### Charge a Saved Card

For orders placed by returning customers who have saved cards:

- Go to **J2Commerce** -> **Orders** and open the order.
- If the customer has saved cards, a **Charge Card** section appears below the **order summary.**
- Select a card from the dropdown.
- Enter the amount to charge (defaults to the order total).
- Click **Charge**.

This is useful for manual reorders, phone orders, or collecting additional payment for shipping adjustments.

![Order Summary with Charge Stored Payment Method form: Visa ending in 4242 selected, Charge Amount 6.75, with the dropdown arrow and Charge Now button highlighted](https://docs.j2commerce.com/images/docs/shared/stripe-refund6.webp)

### Webhook-Triggered Updates

If webhooks are configured, Stripe can update order statuses automatically:

| Stripe Event | What happens in J2Commerce |
| --- | --- |
| `payment_intent.succeeded` | Order status updated to Confirmed |
| `payment_intent.payment_failed` | Order status updated to Failed |
| `payment_intent.canceled` | Order status updated to Canceled |
| `charge.refunded` | Order status updated to Refunded (if enabled) |
| `charge.dispute.created` | Warning logged in the application log |

---

## Saved Cards (Customer Profile)

When **Allow Saved Cards** is enabled, customers can manage their saved cards:

1. Log in to the frontend.
2. Go to **My Account** **->** **Payment Methods**
3. View all saved cards with last 4 digits and expiry.
4. Delete cards they no longer want stored.

   ![My Profile Payment Methods tab highlighted, with the My Account breadcrumb and the saved card Visa ending in 4242, expires 12/31, highlighted](https://docs.j2commerce.com/images/docs/shared/stripe-payment.webp)

## Going Live Checklist

Before accepting real payments, confirm the following:

- [ ] **Sandbox** is set to **No**
- [ ] Your live **Publishable Key** and **Secret Key** are entered
- [ ] The webhook URL is registered in your live Stripe Dashboard
- [ ] The **Webhook Secret** (signing secret) is saved in the plugin settings
- [ ] You have placed a test order using a real card with a small amount and then refunded it
- [ ] **Debug Mode** is set to **No**
- [ ] Payment methods you want to use are enabled in your Stripe Dashboard

---

## Troubleshooting

### "No such payment intent" error at checkout

**Cause:** The Payment Intent was not created correctly, or the API keys are mismatched.

**Solution:**

1. Verify that your **Publishable Key** and **Secret Key** are from the same Stripe account (both live or both test).
2. Check that you are using live keys when **Sandbox** is **No**, and test keys when **Sandbox** is **Yes**.
3. Enable **Debug Mode** and check `administrator/logs/payment_stripe.php` for the full error.

### Payment succeeds but order stays Pending

**Cause:** Webhooks are not configured, so J2Commerce does not receive the payment confirmation from Stripe.

**Solution:**

1. Register the webhook URL in your Stripe Dashboard (see [Webhooks](https://docs.j2commerce.com/v6/payment-methods/payment_stripe#webhooks) above).
2. Enter the **Webhook Secret** (signing secret) in the plugin settings.
3. For Hosted mode, the order status is also updated during the redirect — check if the customer completed the redirect.

### "Currency not supported" error

**Cause:** Your store's active currency is not supported by the selected payment method.

**Solution:**

1. Stripe supports 135+ currencies, but some payment methods have restrictions.
2. Check the Stripe documentation for your payment method's supported currencies.
3. Consider using a currency switcher plugin to offer multiple currencies.

### Credit card form does not appear at checkout

**Cause:** The Publishable Key is missing, incorrect, or the plugin is not enabled.

**Solution:**

1. Go to **J2Commerce** -> **Payments** -> **Payment Methods** and confirm Stripe is enabled.
2. Check that a **Publishable Key** (or **Sandbox Publishable Key** if in sandbox mode) is entered.
3. Enable **Debug Mode** and check the browser console for JavaScript errors.

### Refund fails with an error

**Cause:** The Payment Intent ID is missing from the order, or the charge has already been fully refunded.

**Solution:**

1. Open the order and check that a **Transaction ID** is recorded.
2. If the Transaction ID is empty, the payment may not have been captured correctly. Check the debug log.
3. Log in to your Stripe Dashboard and verify the payment status there.

### Dashboard shows "Stripe is in Sandbox mode" warning

**Cause:** **Sandbox** is set to **Yes**.

**Solution:** If you are ready to go live, open the Stripe plugin settings and switch **Sandbox** to **No**, then enter your live credentials.

### Saved cards not showing at checkout

**Cause:** **Allow Saved Cards** is disabled, or the customer is not logged in.

**Solution:**

1. Verify **Allow Saved Cards** is set to **Yes** in the plugin settings.
2. Saved cards require a logged-in customer with a Stripe customer ID.
3. Check that the customer has previously saved a card in their profile.

### Stripe Link not appearing

**Cause:** **Enable Link** is disabled, or the customer doesn't have Link enabled in their Stripe account.

**Solution:**

1. Verify **Enable Link** is set to **Yes** in the plugin settings.
2. Stripe Link requires the customer to have previously used Link with their email address on any Stripe-powered site.

---

## Support

For help with the Stripe plugin:

- **J2Commerce documentation:** [docs.j2commerce.com](https://docs.j2commerce.com/index.php?option=com_content&view=category&id=8)
- **J2Commerce support:** [www.j2commerce.com](https://www.j2commerce.com/support)
- **Stripe Dashboard:** [dashboard.stripe.com](https://dashboard.stripe.com)
- **Stripe documentation:** [stripe.com/docs](https://stripe.com/docs)
- **Stripe support:** [support.stripe.com](https://support.stripe.com)