Adobe Commerce on cloud infrastructure provides an on-boarding tool to configure PayPal Express Checkout accounts directly through the Admin. This tool is available for ECE 2.1.8 and later. To better support going live and testing PayPal payment methods, you can enable and configure your PayPal Express Checkout account for sandbox or production accounts.
You can configure either the sandbox or production account in every environment:
While we recommend having a PayPal merchant account prepared and configured, you can create an account or upgrade a personal account through the Admin.
PayPal onboarding supports connecting with the following accounts:
If you do not have an existing PayPal account, create a one. Enter an e-mail address for a new account. If a matching PayPal account is not found, follow the prompts to create a PayPal Business account. Or you can create an account directly through PayPal.
PayPal supports connecting PayPal Express Checkout for countries across the globe except for the following limitations:
For Brazil, you must have an existing PayPal business account to connect. You cannot convert an existing personal PayPal account for Brazil during this process. If you need an account, create a business PayPal account through their website.
To configure PayPal Express Checkout:
Access the Admin Console for the environment you need to configure.
In the left-side navigation, select Stores > Configuration, then select Sales > Payment Methods.
For PayPal, select Configure. Configuration fields display in expandable sections for Express Checkout, Advertise PayPal Credit, and Basic and Advanced settings.
Connect your PayPal account. Until the account is connected, the options to enable are disabled. For details on available and supported accounts to connect and limitations, see PayPal account.
Configure the Express Checkout settings to authenticate and use the PayPal API:
For detailed information and steps for configuring your account, see PayPal Express Checkout starting with Step 2 Complete the Required Settings.
With the account configured and authenticated, you can enable and disable PayPal payment options under Required PayPal Settings:
When using the PayPal on-boarding tool with Adobe Commerce on cloud infrastructure 2.2, you need to add the following variable to
magento.app.yaml in the environment variables section.
# Environment variables variables: env: CONFIG__DEFAULT__PAYPAL_ONBOARDING__MIDDLEMAN_DOMAIN: 'payment-broker.magento.com'
If you are upgrading to 2.2 from 2.1.8 or later, you still need to add this variable.