Adobe Commerce Cloud

Last updated: October 19, 2026

Overview

The Adobe Commerce Cloud Shop plugin optimizes payment processing and analytics through seamless integration.

Our Adobe Commerce payment extension helps you launch or expand your business rapidly. If you are launching your business first time on Adobe Commerce, we can help you quickly roll out through our configuration capabilities. If you are already on Adobe Commerce and thinking of expansion, we offer a wide variety of secure local and global payment options.

Our Adobe Commerce extension, built on the Payments Orchestration Platform, delivers a competitive advantage over payment gateways, including payment processing optimization and advanced analytics, through a single integration. We help you manage payments across multiple P2Ps, acquirers, and banks across all channels—online, mobile, or recurring—using a strategic, streamlined approach.

How it works

↑ Back to top

Compatibility

Our plugin supports Adobe Commerce version 2.4.7-p1-EE  or later.

↑ Back to top

Install

↑ Back to top

Configure

You need the Entity ID, API key and webhook decryption key from the Onboard step. The checklist below summarizes the steps; the field reference follows.

Open the plugin settings

In the admin panel, access the payment settings:

1. Access the configuration menu: go to Stores → Settings → Configuration → Sales → Payment Methods → ACI Payments → General Setting.

Field reference

General Setting

window.wpwlOptions={
googlePay: {
        gatewayMerchantId: "ValueOfYourEntityID"
    },
};

Sample Configuration

Figure 1: Sample Configuration

Figure 2: Live Configuration

↑ Back to top

Onboard

After installing the plugin, follow the provided instructions to configure the extension in Adobe Commerce Cloud and the Payments Orchestration Platform using the given configuration details.

You will need to set up merchant accounts and brands in Payments Orchestration Platform to ensure they work with the checkout process using the plugins.

Credentials from the Payments Orchestration Platform

To start processing with plugins, plugin configuration in the Payments Orchestration Platform needs to be enabled for your PSP or merchant. Without this configuration, you won’t be able to send transaction requests from the plugin platform to the payment platform for processing.

Please contact your account manager or project team to enable plugin usage from the Payments Orchestration Platform.

You will need the following information from the Payments Orchestration Platform to configure and onboard with the payment plugin:

Figure 3: Credentials from the Payments Orchestration Platform

Webhook configuration

The webhooks are HTTP-based callbacks that notify your plugin platform of all the events you subscribed for on an entity. Instead of constantly polling for updates, a webhook is set up once and only sends data when a specific event occurs. The events can be about tokens, payments, payment schedules, risks, or any transaction state updates related to payments or transactions connected to a payment, it is necessary to configure webhooks for seamless communication and transaction updates. 

Merchant/PSP to configure webhooks and generate the webhook decryption key in the Payments Orchestration Platform for
webhook handling.

Steps:

1. Login to merchant dashboard (Payments Orchestration Platform)
2. Select your division (here OPP_Division)
3. Go to Administration - Webhooks
4. Click on “Add New Webhook” button

Figure 4: Webhook configuration

Follow further steps below to configure Webhook

1. URL: https://<domain-name>/acipayment/process/notification
2. Notification types: Select the notification types as required by the merchant
3. Fields to include: Select the option as required by the merchant
4. Secret for encryption: (Copy the value and add in the “Webhook Decryption Key” field under general settings in Adobe Commerce Cloud check Sample Configuration)
5. Wrapper for encrypted notification: JSON
6. Emails: Enter email IDs to receive notification alert
7. Save

Figure 5: Webhook configuration (continued)

↑ Back to top

Features

Payment types

Note: Some functionalities available in the plugin might not be supported by the connector in use. Please refer to the respective connector integration sheet for details.

Features

We offer standard plugin integration with Adobe Commerce Cloud through our Payment Orchestration Platform Integration option. This provides you with full access to all features and utilizes COPYandPAY to present payment options to your shoppers.

↑ Back to top

Supported fields

As part of the integration with the plugin platform, we have included the following fields. This information is provided for your reference only; you do not need to handle the transmission or integration of these fields, as the plugin extension manages this automatically.

Please note: The following fields are supported by default. If you require support for any specific fields related to APM for Card brand, please contact your account manager.

• entityId
• testMode
• locale
• amount
• currency
• merchantTransactionId
• paymentType
• customer.givenName
• customer.surname
• customer.phone
• customer.email
• customer.ip
• customer.merchantCustomerId
• registrations[N].id
• billing.city
• billing.country
• billing.postcode
• billing.state
• billing.street1
• billing.street2
• shipping.city
• shipping.country
• shipping.postcode
• shipping.state
• shipping.street1
• shipping.street2
• cart.items[N].name
• cart.items[N].quantity
• cart.items[N].sku
• cart.items[N].price
• cart.items[N].currency
• cart.items[N].description
• cart.items[N].totalAmount

↑ Back to top

Resources

• Installation guide (PDF): Adobe commerce cloud installation guide
• Demo storefront (test environment): https://master-7rqtwti-gkw53q4kgugxg.us-4.magentosite.cloud/
• Marketplace listing: https://commercemarketplace.adobe.com/aciworldwide-payment.html

↑ Back to top

See also

• Shop Plugins overview
• Merchant Portal guide
• Webhooks
• Payment Methods
• 3D Secure