The most common issue during the installation process is getting the following error when using Composer:
Composer package not found: Could not find a matching version of package stripe/stripe-payments
If you encounter this problem, follow these steps:
- Order the module from the Adobe Marketplace.
- Delete the file under
~/.composer/auth.jsonin case you entered the wrong Adobe Commerce API keys.
- Run the Composer command again. You may have to enter a username and password. Make sure that you enter the Adobe Commerce API keys of the account that you used to place the order. You can get your authentication keys from Adobe Commerce.
Upgrades and caching issues
If you upgrade the module but for some reason don’t see the new changes, you can manually clear the Adobe Commerce cache by deleting a set of directories. The official Adobe Commerce documentation describes which directories to delete for Adobe Commerce 2.3 and Adobe Commerce 2.4.
After you delete these directories, run the following commands:
php bin/magento setup:upgrade php bin/magento cache:flush
If you’re running in production mode, you have to compile and deploy your static assets:
php bin/magento setup:di:compile php bin/magento setup:static-content:deploy
If you’re running Varnish, you must also restart Varnish after deleting the var/cache/* files. Some browsers also cache Adobe Commerce requests; if you still have caching issues, try a different browser.
No payment method appear at checkout
The payment method may not show at checkout for a few possible reasons:
- You’re missing the Stripe PHP library or you’re using an old version. You can install this dependency by following step 3 of the installation instructions
- You have another Stripe module installed that’s using an older version of the Stripe PHP library. Disable or uninstall any other active Stripe module.
- You didn’t configure the Stripe API keys properly.
- You limited the availability of the payment method to specific countries or currencies.
The Apple Pay or Google Pay button doesn’t appear
If you configured the Payment Request button and it still doesn’t appear, try the following:
- Make sure that you enabled Apple Pay and Google Pay in your payment methods settings.
- For Apple Pay, use Safari on an iPhone running iOS 10 and above.
- For Google Pay, use Chrome Desktop or Chrome Mobile with a logged in Google account.
- Make sure that you have at least one card in your Wallet. – In iOS, you can add a card by going to Settings > Wallet > Apple Pay. – In Chrome, you can add a card by going to Settings > Autofill > Payment methods > Add new credit card.
- Confirm that your iOS device supports Apple Pay.
- Confirm that your Android device supports Google Pay.
- For Apple Pay, authenticate your domain name using these instructions.
- If your website domain starts with
www, make sure the domain is
- You must serve your website over HTTPS using a valid TLS 1.2 certificate—check this from your browser or from SSL Labs.
- Make sure that you enabled the Wallet button in the module’s configuration section.
- Make sure that you configured a default fallback country (Stores > Configuration > General > Country Options > Default Country).
- Make sure that you’re not using an older Stripe API key. Apple Pay requires a modern API key, which starts with
pk_test_. You can roll your publishable key in the Developers section of the Dashboard.
- If you’re using a OneStepCheckout module, you may additionally need to configure the OSC module to refresh the payment form when guest customers submit their billing address. In most cases, this isn’t necessary.
If Apple Pay appears at checkout, but it doesn’t appear on the product pages, it may be because of additional reasons:
- You disabled guest checkouts from the Adobe Commerce admin.
- Your website is serving your product pages without a valid TLS 1.2 certificate.
- You overwrote the Add to Cart button template in your theme. Try adding some text to
app/code/StripeIntegration/Payments/view/frontend/templates/express/product_button.phtml. If your product pages remain unchanged, customize your theme and integrate the two templates together.
Order stuck in pending status
When creating an order, the initial status is
Pending, which indicates that the authorization of the payment by the customer’s bank is still pending. For all redirect-based payment methods, when an authorization occurs, Stripe notifies your website using webhooks. If your orders don’t change from
Processing, this might indicate that webhooks are missing or incorrect.
Go to your webhooks settings to check if a webhook endpoint with your store URL exists. If not, you can try to manually create it by running the following command from your Magento root directory:
If the webhook endpoint already exists, check the Error Rate to identify the failing webhooks. You can click on the webhook endpoint to see the error messages. To get assistance on webhook issues that aren’t due to incorrect server configuration, contact us at firstname.lastname@example.org while sharing the details about the errors you encounter.
After fixing the webhook issue, you need to resend the
charge.succeeded events that weren’t delivered correctly to your website. The module provides three commands to resend a single event, a range of events, or events within a date range:
bin/magento stripe:webhooks:process-event [-f|--force] <event_id> bin/magento stripe:webhooks:process-events-range <from_event_id> <to_event_id> bin/magento stripe:webhooks:process-events-date-range <from_date> [<to_date>]
You can get a list of all failed
charge.succeeded events in the Developers section of your Stripe Dashboard and decide which ones to resend using one of the commands above.
Error logging and server-side errors (HTTP 500)
Adobe Commerce logs any errors and exceptions it encounters during application runtime in the
var/log directory. You can find these errors in the following two files:
If you have SSH access, you can filter the error messages with the following command:
grep -i Stripe var/log/system.log
You can display errors live in the console as they occur (or when you refresh a given page). To monitor errors, run the following command to watch the error log:
tail -f var/log/*
If you don’t have shell access, you can download this file and search for Stripe errors with a text editor.