v11.1.0 ‐ Release testing instructions - woocommerce/woocommerce-gateway-stripe GitHub Wiki
The critical flows remain the base for this release. The sections below cover the changes in 11.1.0 that need specific testing steps.
Many fixes in this release touch Optimized Checkout, Adaptive Pricing, and express checkout, so run the card, saved card, SCA, and express checkout critical flows with Optimized Checkout enabled and disabled, and once with Adaptive Pricing enabled.
Some steps use a code snippet. Add it with a snippets plugin (for example Code Snippets), or as a file in wp-content/mu-plugins/, and remove it after the test.
Test mode set up when onboarding a live account
- On a store with no Stripe connection, go to WooCommerce > Settings > Payments > Stripe and connect a live account.
- After onboarding, the store should still be in live mode.
- Switch to test mode in Stripe settings > Settings tab. It should be available without a separate test-mode connection.
- Complete a test payment.
Optimized Checkout
BLIK and ACSS
- Enable the Optimized Checkout Suite in Stripe settings > Settings tab > Advanced settings.
- Enable BLIK (store currency PLN) or Pre-Authorized Debit (ACSS) (store currency CAD) in Stripe settings > Payment Methods tab.
- On classic and Blocks checkout, BLIK or ACSS should show as its own payment option next to the Optimized Checkout element, not inside it and not twice. The browser console should show no
IntegrationError. - Complete a payment with BLIK (test code
123456) or ACSS.
On-page 3D Secure modal
- With Optimized Checkout enabled and Adaptive Pricing disabled, go to the Blocks checkout and pay with a new card
4000 0027 6000 3184. - The 3D Secure modal should open on the checkout page. Before this release, the shopper was redirected to a full Stripe page.
- Click Complete. The order should be Processing.
- A saved card should still pay without 3D Secure, and a redirect method such as Bancontact should still redirect.
Adaptive Pricing
Enable the Optimized Checkout Suite and Adaptive Pricing, and make sure the store receives webhooks.
Retry with a saved card after a decline
- Log in as a customer with a saved card. Go to the classic checkout.
- Select a new card, pay in a local currency other than the store currency, and use the decline card
4000 0000 0000 0002. A decline error should show. - Without reloading, pay with the saved card. The payment should succeed.
Checkout without a billing country field
- Add this snippet:
add_filter( 'woocommerce_checkout_fields', function ( $fields ) { unset( $fields['billing']['billing_country'] ); return $fields; } ); - In a private window, add a virtual product to the cart and go to the classic checkout. There should be no billing country field.
- Fill in the other billing fields, select a country in the Stripe payment element, and pay with
4242 4242 4242 4242. - The order received page should load, with no
billingAddress.address.countryerror.
Order paid with another gateway
- Enable Check payments in WooCommerce > Settings > Payments.
- Start a Stripe payment at checkout, but don't complete it.
- Place the same order with Check payments. The order should be On hold.
- Expire the Checkout Session in Stripe: get its ID from the order meta
_stripe_checkout_session_id, then runstripe checkout sessions expire cs_test_...with the Stripe CLI. - The order should stay On hold, with no expiry note and no failed or cancelled email.
Cart updates during checkout
- On the checkout page, change the quantity or the shipping method, then place the order. Both should work.
- In the database, no
wc_stripe_checkout_session_lock_*row should be left inwp_optionsafterwards.
Express checkout line items
Enable Apple Pay / Google Pay or Link in Stripe settings > Payment Methods tab > Express checkouts, with the buttons shown on the cart, checkout, and product pages. Link is the easiest option on a local site.
Coupons and negative fees
- Add a product to the cart and apply a percentage coupon. Open the express checkout sheet from the classic cart and from the classic checkout. The discount should show as a negative amount and the total should be correct. Complete the payment.
- Add this snippet, which adds a negative fee:
add_action( 'woocommerce_cart_calculate_fees', function ( $cart ) { $cart->add_fee( 'Test discount', -5 ); } ); - Open the express checkout sheet from the classic cart. It should open, show the fee as a negative line item, and show the correct total.
- Change the fee to
5(a surcharge). It should show as a positive line item.
Negative fee on the Pay for Order page
- Keep the negative fee snippet. As a logged-in customer, place an order with Check payments so it stays unpaid.
- In wp-admin, open the order and copy the Customer payment page link. Open it as the same customer.
- Click the express checkout button. The sheet should open with the fee as a negative line item, and the payment should complete.
Free-trial subscription with shipping
- With WooCommerce Subscriptions active and a shipping method set up, create a physical subscription product with a free trial.
- Add it to the cart, go to the Blocks checkout, and click the Link button.
- Enter a shipping address. Shipping should show as Pending (Free) and Continue should be enabled.
- Pay with
4242 4242 4242 4242. The order total should be 0 and the subscription should be active. - Repeat with a regular physical product. Real shipping rates should show and the purchase should complete.
Required custom checkout fields
- Add this snippet, which adds a required classic checkout field:
add_filter( 'woocommerce_billing_fields', function ( $fields ) { $fields['billing_my_custom_field'] = [ 'type' => 'text', 'label' => 'My custom field', 'required' => true, ]; return $fields; } ); - With the Checkout block on the checkout page, pay with an express button from the checkout page and from the cart. The order should complete.
- Switch the checkout page to the
[woocommerce_checkout]shortcode. - From the product page and the cart, click an express button. It should refuse the payment with a "required field" message that links to the checkout page.
- On the checkout page, leave the field empty and pay with an express button. It should refuse with "My custom field is a required field.".
- Fill in the field and pay again. The order should complete and the value should be saved in the order's custom fields.
Sofort removed from checkout
- Set the store currency to EUR.
- Sofort should not be offered on classic or Blocks checkout, and should not be listed in Stripe settings > Payment Methods tab.
- If you have an existing Sofort order, a refund from wp-admin should still work. If you have an existing Sofort subscription, its renewal should still process.
Payment method settings
Errors when saving payment methods
- Make Stripe reject the Payment Method Configuration update, for example by enabling a combination of payment methods your Stripe account doesn't support.
- Enable or disable a payment method in Stripe settings > Payment Methods tab and save.
- The notice should show the reason from Stripe instead of Settings saved., and the change should not be shown as saved after a reload.
Payment methods with a multi-currency plugin
- Set the store currency to USD. In Stripe settings > Payment Methods tab, SEPA Direct Debit should show the Requires currency pill and be disabled.
- Activate a currency plugin that offers EUR (for example WPML Multilingual & Multicurrency for WooCommerce), and add this snippet:
add_filter( 'wc_stripe_available_store_currencies', function ( $currencies ) { $currencies[] = 'EUR'; return $currencies; } ); - Reload the settings. SEPA should be enabled without the pill. Enable it and save.
- On the store, switch to EUR, add a product, and go to checkout with the billing country France. SEPA should be offered, and the order should complete.
Connection errors
- In WooCommerce > Settings > Payments > Stripe, find a Create or connect button.
- Open the browser console and run
wc_stripe_settings_params.oauth_nonce = 'invalid'. Click the button. - The notice should say Your session has expired. Please reload the page and try again., link to the setup documentation, and the button should be enabled again.
- Reload. In the browser developer tools, block the
admin-ajax.phprequest and click the button. The notice should say An issue occurred generating a connection to Stripe. Please try again.. - Stop blocking the request, reload, and click the button. The Stripe connection page should open.
Orders and payment status
Unpaid orders are checked with Stripe before they are cancelled
- Enable Hold stock in WooCommerce > Settings > Products > Inventory.
- Pay for an order with Stripe, but don't let the confirmation reach the site (for example, stop the webhook listener), then set the order back to Pending payment.
- In WooCommerce > Status > Scheduled Actions, run
woocommerce_cancel_unpaid_orders. - The order should not be cancelled. It should move to Processing (or On hold for an authorized payment), with an order note.
- An order with no Stripe payment should still be cancelled.
Payment confirmation and webhooks at the same time
- Pay with the 3D Secure card
4000 0027 6000 3184while webhooks are delivered. The order should be paid once: one payment note and one set of stock reductions. - With WooCommerce Pre-Orders active and a pre-order product charged upfront, pay with the same card and close the browser right after the 3D Secure step. The webhook should settle the order as Pre-ordered, not Processing.
Saved payment methods
- In My Account > Payment methods, save two cards and set the second one as default.
- Go to the Blocks checkout. The default card should be selected. Place the order.
- With a Link account: buy a subscription with Link, then pay again through the same Link email with a different card. The saved Link method and the subscription should use the new card.
Klarna for Puerto Rico shoppers
- With a US Stripe account and Klarna enabled, disable Optimized Checkout and Adaptive Pricing.
- On classic and Blocks checkout, set the billing country to Puerto Rico. Klarna should be offered, and the payment should complete.
Agentic Commerce
These steps need Agentic Commerce enabled in Stripe settings > Agentic Commerce tab.
- Shipping rates from cart contents. Create a flat rate shipping method with the cost
2 * [qty]. In an agentic checkout of one item, the quoted shipping should be2.00, and the created order should use that flat rate. - Shipping zone warnings. Create a shipping zone with no flat rate method. Click Preview feed: a warning should list the zone. After a sync, the plugin log should include a "zone has no flat-rate method" warning.
- Add-on products. Add Product Add-Ons to a product. In Preview feed, the product should be marked as excluded. Turn off Exclude products with add-ons or configurators from the feed and it should be included again. Then turn on Redirect shoppers to my store and the product should be marked to check out on the store.
- Order origin. Complete an agentic checkout. In WooCommerce > Orders, the Origin column should show the agent name (enable the column in Screen Options if hidden).
- Sync. Click Sync now. It should complete, and a second click during the sync should show A sync is already in progress.
Fixes worth a smoke pass
- A classic checkout with a required checkbox or textarea added by another plugin should show Please fill in all required fields. when it is empty, and should not create an order or a Stripe payment method.
- Express checkout on a store with a zero-decimal currency and price rounding (for example CZK with WPML) should open the wallet and show the total.
- Amazon Pay express checkout should complete, and Level 3 data should still be sent for card payments.
- On an OAuth-connected store, payments should complete with no application fee in the Stripe Dashboard.
- A subscription renewal that fails because its Stripe mandate is invalid should add the order note The mandate used for this renewal payment is invalid. You may need to bring the customer back to your store and ask them to resubmit their payment information.
- Test card numbers and Learn more links in Stripe settings > Settings tab open in a new tab.
- The Webhook row in Stripe settings > Settings tab shows pending webhooks with a single period at the end of the message.
- The Stripe settings pages, the Blocks checkout, and express checkout load normally after the JavaScript bundle size reductions.