How to Guides

These tasks assume version 2.0.0 or newer on J2Commerce v6 and a working product catalog unrelated to Stripe itself.

How do I go from staging test to live safely?

Complete at least one full test checkout with test mode on and webhooks delivering success in Stripe Dashboard. Copy live keys into the live fields, create or clone a live webhook endpoint with the same subscribed events, paste the live signing secret, disable test mode, save, assign the payment method to production profile if profiles differ, and run one small live charge you can refund. Monitor the first live day in Stripe Dashboard for failed webhook deliveries.

How do I rotate Stripe keys?

Generate new keys in Stripe Dashboard, update plugin options for the matching mode, save, and run one checkout. Roll old keys off in Stripe only after checkout succeeds with the new pair. Rotate webhook signing secrets the same way: update Stripe endpoint, paste new secret, save, trigger a test event.

How do I customize shopper-facing messages?

Edit onbeforepayment, onafterpayment, onerrorpayment, and oncancelpayment textarea defaults in Advanced tab to match your shop tone and async payment expectations. Defaults already mention bank payment delay for ACH-style methods; adjust if your Stripe methods differ.

How do I set a thank-you article?

Use the articleid modal field to pick a com_content article J2Commerce should reference for thank-you messaging when your workflow uses that hook. This is optional polish, not a substitute for order confirmation email configuration elsewhere.

How do I use manual capture?

Set capture_method to manual, complete checkout to authorize, then capture within Stripe Dashboard before authorization expires. Train staff who expect automatic paid status in J2Commerce immediately, because manual capture orders may look authorized-but-not-captured until someone completes capture in Stripe.

How do I confirm webhooks are healthy?

In Stripe Dashboard, open the endpoint, inspect recent deliveries for HTTP success responses from your site, and correlate timestamps with test orders. If deliveries fail signature verification, re-copy signing secret from Stripe into plugin options without stray spaces.