ÃÛ¶¹ÊÓÆµ

Onboarding Payment Services flow

To get started using Payment Services, you must complete a few onboarding steps. For accurate guidance, please select the ÃÛ¶¹ÊÓÆµ 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 ÃÛ¶¹ÊÓÆµ Commerce version to onboard with Payment Services.

Help me find my instance and version

ÃÛ¶¹ÊÓÆµ Commerce or Magento Open Source | v2.4.7+

These flow diagrams show the general process for onboarding Payment Services with an ÃÛ¶¹ÊÓÆµ Commerce or Magento Open Source newer than v2.4.7.

Sandbox

This flow diagram shows the onboarding sandbox process with an ÃÛ¶¹ÊÓÆµ Commerce or Magento Open Source newer than v2.4.7, where Payment Services is out-of-the-box with ÃÛ¶¹ÊÓÆµ 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 ÃÛ¶¹ÊÓÆµ Commerce on Cloud projects only (ÃÛ¶¹ÊÓÆµ-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.

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

ÃÛ¶¹ÊÓÆµ Commerce or Magento Open Source | v2.4.0-2.4.6 [PaaS only]{class="badge informative" title="Applies to ÃÛ¶¹ÊÓÆµ Commerce on Cloud projects only (ÃÛ¶¹ÊÓÆµ-managed PaaS infrastructure)."}

These flow diagrams show the general process for onboarding Payment Services with ÃÛ¶¹ÊÓÆµ 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 ÃÛ¶¹ÊÓÆµ 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.

Production

This flow diagram shows the general process for enabling Payment Services in a production environment with ÃÛ¶¹ÊÓÆµ 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