Troubleshoot Payment Services installation
This article explains the errors you’ll encounter during Payment Services installation and shows you how to fix them so you can complete the setup successfully.
Description description
Environment
Adobe Commerce versions 2.4.0 - 2.4.4 (Payment Services)
Issues
Here are the errors you can encounter when installing Payment Services:
1. Incorrect Composer keys
An error message appears during installation if you use incorrect Composer keys for the Payment Services extension.
Steps to reproduce
- Attempt to install Payment Services.
- You see the following error:
- Could not find a matching version of package magento/payment-services. Check the package spelling, your version constraint and that the package is available in a stability which matches your minimum-stability (stable).
Expected result
You follow the installation instructions in the developer documentation and install Payment Services successfully.
Actual result
You see an error message stating that you used incorrect Composer keys during installation.
Cause
The Composer keys used during installation don’t match the Magento ID used to register for Payment Services.
2. Shared dataspace in multi-instance setup
An error message appears when multiple instances of Payment Services share the same dataspace in a multi-environment setup.
Cause
Each instance must use a separate SaaS dataspace. Sharing one across environments causes conflicts.
3. Insufficient PHP memory
An error message appears during installation if your PHP configuration doesn’t meet the required memory limit for the Payment Services extension.
Steps to reproduce
- Attempt to install Payment Services.
- You see the following error (or something similar):
- Fatal error: Allowed memory size of 2146435072 bytes exhausted (tried to allocate 4096 bytes) in phar:///usr/local/bin/composer/src/Composer/DependencyResolver/RuleWatchGraph.php on line 52
Expected result
You follow the installation instructions in the developer documentation and install Payment Services successfully.
Actual result
You see an error message stating that there isn’t enough memory for PHP.
Cause
The PHP memory limit in your environment is set too low.
Resolution resolution
Issue: Incorrect Composer keys
Solution
Verify that your Composer keys are linked to the same Magento ID you used when registering for Payment Services.
Issue: Shared dataspace across multiple instances
Solution
You can use the same API key across instances, but each instance must use its own SaaS dataspace.
When you create a SaaS project, Commerce generates dataspace(s) based on your license:
- Adobe Commerce: One production dataspace and two testing dataspaces
- Magento Open Source: One production dataspace only
Follow the instructions in the Commerce API key and private key guide to configure each instance correctly.
Issue: Not enough memory for PHP
Solution
Increase the memory limit in your php.ini file to meet the requirements for installing the Payment Services extension.