Onboarding Payment Services flow

To get started using Payment Services, you must complete a few onboarding steps. For accurate guidance, please select the Adobe Commerce option below that best aligns with your organization’s instance and version.

This flow diagram shows the general process for onboarding Payment Services in all versions:

Onboarding flow {width="700" modal="regular"}

See below for your specific Adobe Commerce version to onboard with Payment Services.

Help me find my instance and version

Adobe Commerce or Magento Open Source | v2.4.7+

These flow diagrams show the general process for onboarding Payment Services with an Adobe Commerce or Magento Open Source newer than v2.4.7.

Sandbox

This flow diagram shows the onboarding sandbox process with an Adobe Commerce or Magento Open Source newer than v2.4.7, where Payment Services is out-of-the-box with Adobe Commerce.

Onboarding flow {width="700" modal="regular"}

Onboarding steps for versions v2.4.7+ Part 1: Sandbox

  1. Connect your instance to Commerce Services. This connect must be completed only once per Commerce instance. [PaaS only]{class="badge informative" title="Applies to Adobe Commerce on Cloud projects only (Adobe-managed PaaS infrastructure)."}
  2. Set up the sandbox service (or, alternatively, proceed to enabling live payments if you’ve tested functionality in another environment) with a test PayPal payment processing account.
  3. Test Payments in a sandbox environment.

learn more

Production

This flow diagram shows the production steps needed to enable Payment Services.

Onboarding flow {width="700" modal="regular"}

Onboarding steps for versions v2.4.7+ Part 2: Production

  1. Set Payment Services as your payment method, in sandbox mode, to start processing test payments.
  2. Request payments entitlement to enable live onboarding.
  3. Complete merchant onboarding to enable live payments for your Commerce websites.
  4. Get your Payment Services Merchant ID and hand it to Sales to configure the correct pricing tier.
  5. Enable Payment Services in live mode to begin processing live payments.
  6. Test Payments, in both sandbox and production environments.

learn more

Adobe Commerce or Magento Open Source | v2.4.0-2.4.6 [PaaS only]{class="badge informative" title="Applies to Adobe Commerce on Cloud projects only (Adobe-managed PaaS infrastructure)."}

These flow diagrams show the general process for onboarding Payment Services with Adobe Commerce or Magento Open Source versions 2.4.0 to 2.4.6. It is needed to download and install Payment Services to begin onboarding.

Sandbox

This flow diagram shows the sandbox steps required for onboarding Payment Services with Adobe Commerce or Magento Open Source versions 2.4.0 to 2.4.6.

Onboarding flow {width="700" modal="regular"}

Onboarding steps for versions v2.4.0-2.4.6 Part 1: Sandbox

  1. Install the Payment Services extension if necessary.
  2. Obtain API credentials.
  3. Connect your instance to Commerce Services. This connect must be completed only once per Commerce instance.
  4. Set up the sandbox service (or, alternatively, proceed to enabling live payments if you’ve tested functionality in another environment) with a test PayPal payment processing account.
  5. Test Payments in a sandbox environment.

learn more

Production

This flow diagram shows the general process for enabling Payment Services in a production environment with Adobe Commerce or Magento Open Source versions 2.4.0 to 2.4.6.

Onboarding flow {width="700" modal="regular"}

Onboarding steps for versions v2.4.0-2.4.6 Part 2: Production

  1. Set Payment Services as your payment method, in sandbox mode, to start processing test payments.
  2. Request payments entitlement to enable live onboarding.
  3. Complete merchant onboarding to enable live payments for your Commerce websites.
  4. Get your Payment Services Merchant ID and hand it to Sales to configure the correct pricing tier.
  5. Enable Payment Services in live mode to begin processing live payments.
  6. Test Payments, in both sandbox and production environments.

learn more

NOTE
If you do not configure your Commerce Services in the Admin (Part 1), you cannot set up sandbox or live payments.
recommendation-more-help
00b8a45a-5862-4817-8e1e-074170ebb953