Explanation:
There are several reasons as to why an error may occur on your Magento-based site’s checkout page when Cash App Afterpay as the payment method is attempted.
Please refer to the Action section to further understand and resolve the challenge.
Actions:
Please review and follow the various reasons and solutions below:
-
Incorrect API Credentials
- Causes:
- Invalid or outdated Cash App Afterpay API keys or Merchant IDs.
- Sandbox credentials used in production, or vice versa.
- Solution:
- Go to Stores > Configuration > Sales > Payment Methods > Cash App Afterpay.
- Double-check the Merchant ID and Public/Private API keys.
- Ensure you're using live credentials in production and sandbox credentials in staging.
- Causes:
-
Cash App Afterpay Not Enabled in Admin
- Cause: Cash App Afterpay is disabled in the backend config.
- Solution:
- Go to Stores > Configuration > Sales > Payment Methods > Cash App Afterpay, enable the module.
- Save and flush cache.
-
Plugin or Extension Not Installed or Outdated
- Causes:
- The official Cash App Afterpay module for Magento isn’t installed or is not the latest version.
- Conflicts with other installed extensions.
- Solution: Please ensure the official Cash App Afterpay plugin is installed, also to check Cash App Afterpay's official Magento documentation for version compatibility.
- Causes:
-
Customization on Magento CE Causing Conflicts
- Cause: Custom code and modules on Magento Community Edition interfering with Cash App Afterpay logic or checkout flow.
- Solution:
- Please isolate the custom module by disabling it temporarily, revert any custom templates or JS files that override default payment or checkout behavior, and check if customization overrides layout XML that might remove or move Cash App Afterpay blocks.
- Compare with a clean CE install and test behavior, and co-ordinate with the developer to refactor custom logic to be compatible with Cash App Afterpay’s integration points.
-
SSL Certificate Issues
- Cause: No HTTPS - Cash App Afterpay requires secure connections.
- Solution:
- Ensure SSL certificate is installed and site is accessible via HTTPS.
- Update Magento’s base URL settings to use https://.
-
Country or Region Restrictions
- Cause: Cash App Afterpay disabled for certain countries or regions.
- Solution:
- In Cash App Afterpay config, set “Allowed Countries” to either “All” or the specific countries supported by your Cash App Afterpay account.
- Check if shipping/billing addresses fall within those allowed regions.
-
Minimum/Maximum Order Value Limits
- Cause: Order total outside Cash App Afterpay limits.
- Solution: Check the cart subtotal and adjust the cart to fall within the limits.
Important Notes:
Cash App Afterpay is available for Adobe Commerce (Magento 2) merchants with a store address in the United States only.
Related Links: