Magento Boarding Guide

Magento Boarding Guide

Magento is the free, open-source version of Adobe Commerce. It’s a flexible eCommerce platform that gives merchants control over products, orders, and payments.

This guide provides configuration steps for the Visa Acceptance Solutions payment extension, covering payment acceptance, fraud management, and order services for Unified Checkout (including Cards, Apple Pay, Google Pay, and Click to Pay). While Adobe Commerce is referenced throughout, the instructions also apply to Magento Open Source.

Before setting up the integration, please ensure the following:

  • You are registered with a Live Payments ‘eCommerce / ISV’ account.
  • You have received your ISV Configuration Kit from the Live Payments CS or Applications team. This kit includes essential information such as API credentials and configuration details required for Magento setup.

If you haven’t received the ISV Configuration Kit or are unsure about your account setup, please contact help@livepayments.com or call 1300 780 788 for assistance.

1.     Place an order in the Adobe Commerce Marketplace with the Visa Acceptance Solutions module:
  1. https://commercemarketplace.adobe.com/cybersource-module-payment.html  

2.     Go to My Profile > My Products > Access Keys and copy the keys.

{
"http-basic": {

"repo.magento.com": {

"username": "Your_Public_Key",

"password": "Your_Private_Key"}
}

}

3.     Rename the auth.json.sample file to auth.json in your server's Magento root directory and enter your access keys.

4.     Run the below commands in your Magento root directory.

composer require cybersource/module-payment
php bin/magento module:enable CyberSource_Payment
php bin/magento setup:di:compile
php bin/magento indexer:reindex
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy -f
php bin/magento cache:clean
php bin/magento cache:flush
php bin/magento module:status

 

General Settings
This section provides General Settings Configuration details for the Visa Acceptance Solutions extension in Adobe Commerce.

Serial

Number

Settings

Description

1

Environment

Set as “Production”

Note: Do NOT set as ‘sandbox’ as our ISV KIT is for Production only

2

Merchant ID

Your Visa Acceptance Solutions Merchant ID

3

API Key

Refers to a specific key provided by a payment gateway to authenticate and authorize the merchant's integration with the gateway.

4

API Shared

Secret

Refers to a confidential or private key used for secure communication between the merchant's online store and a payment gateway.

5

Debug Mode

Enabling debug mode provides an option to troubleshoot using the Visa Acceptance Solutions logs, named cybersource.log. The diagnostic information will be stored in log files in the Adobe Commerce web server.

 

A screenshot of a computer AI-generated content may be incorrect.

Configuration Details

To configure the Visa Acceptance Solutions extension, a merchant needs to log in to the administration section of their Adobe Commerce website.

The configuration panel can be accessed by navigating to the following screen:
Stores > Configuration > Sales > Payment Methods

On the payment methods screen, you will see the settings to configure the Visa Acceptance Solutions extension.


This section provides the configuration details of the services supported by Visa Acceptance Solutions extension in Adobe Commerce for Unified Checkout Integration.

Sl. No.

Settings

Description

1

Enable

Choose Yes to enable the Visa Acceptance Solutions extension.

2

Title

Customers see the text saved here as the payment method name.

3

Payment Action

Set as ‘Capture’


Important: This option determines whether payments are Authorize or Captureduring customer checkout.

If you prefer to use ‘Authorize’, please ensure you fully understand how the Authorize and Capture process works, as explained later in this document.

4

Payment Card Types

Select the payment card brands you wish to accept.

  • Make sure to include Visa and Mastercard.
  • If your account is registered for American Express, be sure to enable it as well.

 

Important: As of this writing, no other card schemes are supported. We aim to expand support in the coming months and years. If you'd like to request a specific card scheme, please submit a feature request by emailing help@livepayments.com.

5

Allowed Payment Method

Select the payment methods that customers can use to complete their orders.

  • Make sure to include ‘Payment Card’.
  • If you wish to enable ‘Click to Pay’, ‘Google Pay’, and/or ‘Apple Pay’, please ensure you have informed us so we can enable them on our end.

 

Important: Apple Pay requires additional setup, which is covered later in this document.

6

Select Layout

Choose Embedded or Side bar as the layout to display the Unified Checkout Integration payment widget.

7

Payment from Applicable

Countries

By choosing All Allowed Countries, the payment method will use the Adobe Commerce global settings for the customer’s country. By choosing Specific Countries, the merchant can manually choose the allowed countries for the customer.

 

Important: We only support payments in AUD currency. If a customer places an order from a high-risk country or uses an international card, the transaction may be declined by our fraud screening system.

If you believe the transaction is legitimate, please submit a fraud review request by emailing help@livepayments.com.

8

Payment from Specific

Countries

Choosing countries in this setting allows the store owner to specify which countries are allowed for our payment method.

9

Payer Authentication /  3-D Secure

This feature is not currently supported, but we plan to enable it in the near future.

(Note: This option adds an additional layer of security to payments by authenticating the customer’s identity before authorization.)

10

Tokenization

This feature is not currently supported, but we plan to enable it in the near future.

(Note: Enabling this option allows customers to save their payment cards for future payments.)

11

Tokenization Title

This feature is not currently supported, but we plan to enable it in the near future.

(Note: This text specifies the title of the saved card payment method.)

12

Saved Card Verification

This feature is not currently supported, but we plan to enable it in the near future.

(Note: This option allows the merchant to configure whether saved card transactions are processed with CVV. )

13

Enforce Strong Customer

Authentication

This feature is not currently supported, but we plan to enable it in the near future.

(Note: If enabled, the card holder will be 3DS challenged when saving a card. )


To enable Apple Pay you must first host a public certificate on your web page and then pass your merchant name and domain name to Apple. Apple crawls out to your web page to validate the presence of this certificate to ensure the web pages are properly vetted and registered with Apple. Follow these steps to validate your domain and enrol in Apple Pay:

Step 1: Request Apple Pay Verification Certificates
Contact Live Payments at help@livepayments.com to request the Apple Pay verification certificates. Please provide the following information:

    1. Your Cybersource Merchant ID, as detailed in the ISV Configuration Kit provided by the Live Payments team.
    2. The domain name (e.g. https://mydomain.com) or sub-domain (e.g. https://shop.mydomain.com) where you want to enable Apple Pay.
  1. Note: If you are setting up Apple Pay on multiple sites, please specify each Cybersource Merchant ID along with the corresponding domain name. 

Step 2: Host the Certificate:
  1. Place the certificate you got from us through step 1 in the following folder location on your web server:
    https://[DOMAIN_NAME]/.well-known/apple-developer-merchantid-domain-association

  2. Once the file is hosted, please notify us.
Step 3: Verify the domain

After the certificate is hosted, Live Payments will verify your domain(s) with Apple using the domain link details provided in Step 1. We will notify you once the verification is complete.

Your domain will then be verified for Apple Pay.

Important: Non-profit merchants must take additional steps to enable Apple Pay. Please refer to Apple Pay for Donations for more details.

 

Managing Orders

Merchants can manage follow-up order management services in Adobe Commerce Back Office after placing an order from the Adobe Commerce Front Office.

The merchant side services in Adobe Commerce Back Office are: 

• Full authorization reversal 
• Authorization capture or multiple partial captures 
• Standard refund and partial refund

Merchants can perform a full authorization reversal after an authorization. To cancel a completed order authorization, the merchant can click Cancel 

 

While in authorize mode, the system will create an order record, but not an invoice. Capturing funds for authorized transactions is done implicitly when you prepare an invoice. To create an invoice, navigate to the below path in the administration section of Adobe Commerce: Navigate to Sales > Orders > choose an Order Pending invoice > then click Invoice.

A screenshot of a computer AI-generated content may be incorrect.

The merchant can perform a full capture or multiple partial captures using the invoice button. When creating an invoice, the merchant can do multiple partial captures by choosing specific quantities.

Alternatively, the merchant can do complete capture by choosing the entire order.

A screenshot of a computer AI-generated content may be incorrect.

 To complete invoice creation and capture funds, click Submit Invoice.

A screenshot of a computer AI-generated content may be incorrect.

A screenshot of a computer AI-generated content may be incorrect.

You must create a credit memo to refund a captured order.

To refund an order, navigate to the administration section of your Adobe Commerce website: Sales > Orders > open an invoiced order > click Invoices from the left panel > and click View.

A screenshot of a computer AI-generated content may be incorrect.

 

Click View on an invoice to open it. You can create a credit memo within the invoice record.

A screenshot of a computer AI-generated content may be incorrect.
 

 

 

 

When creating a credit memo, you can refund all or part of an invoice. To issue a partial refund, alter the numbers in the Qty to Refund column. Click the Update Qty’s button.

A screenshot of a computer AI-generated content may be incorrect.

 To complete the credit memo, click Refund.

A screenshot of a computer AI-generated content may be incorrect.

 
A screenshot of a computer AI-generated content may be incorrect.

This extension supports the following payment methods and services.

These services can be enabled or disabled using the admin panel configuration:

Payment Card 

• Payment acceptance services 
• Payment security services 
• Fraud management services 
• Order management services 

Google Pay

• Payment acceptance services 
• Fraud management services 
• Order management services 

Click to Pay

• Payment acceptance services 
• Order management services 

Apple Pay

• Payment acceptance services 
• Order management services 

A screenshot of a computer AI-generated content may be incorrect.
             

A blue screen with white text AI-generated content may be incorrect.

If you require any assistance configuring the plugin or if you encounter any unexpected hurdles, please lodge a ticket by sending an email to help@livepayments.com


    • Popular Articles

    • Taking a Payment

      With your mobile terminal, the following payment types and methods are accepted: Contactless payments (Tap & Go), chip insert and swipe Visa, Mastercard, American Express, and eftpos Google Pay, Apple Pay and Samsung Pay To take a payment, you will ...

    • Taking a Payment on your PAX A920Pro

      The following payment types and methods are accepted: Contactless payments (Tap & Go), chip insert and swipe Visa, Mastercard, American Express, and eftpos Google Pay, Apple Pay and Samsung Pay To take a payment, from the Standalone Payments Home ...

    • Tipping

      Tipping can be switched on or off by contacting customer support. Tip options of Round Up, two variable percentages (e.g., 5%,10%) and a custom amount are displayed on the Confirmation screen. Your customer selects a tip option and presses Add tip, ...

    • When will I get paid?

      Transactions processed before midnight will be paid within the next day, excluding weekends.

    • Get started with the PAX A920Pro

      Your PAX A920pro terminal is preconfigured to start accepting payments right away and will automatically connect to the Telstra 4G network, or you can connect with Wi-Fi. ‍ ‍Charge terminal Before proceeding with the setup, please connect your PAX ...

    • Related Articles

    • Prestashop Boarding Guide

      Before You Start Before you attempt to set up the integration, please ensure you have/are using the following: From Live Payments Registration for an ‘eCommerce / ISV’ account If you are unsure whether your account is properly configured to support ...

    • WooCommerce Boarding Guide with SkyVerge's plugin

      Overview WooCommerce is a third party plugin that turns your WordPress site into an eCommerce store. Skyverge’s WooCommerce plugin uses Cybersource’s Flex Microform payment form, ensuring your page meets SAQ A PCI compliance whilst also providing a ...

    • WooCommerce Boarding Guide with VISA Acceptance Solutions' plugin

      Overview The following sections provide an overview of the plugin and step-by-step installation instructions for WooCommerce. Recent Revisions to This Document 25.11.03 Support for version 2.0.1 25.10.02 Changes in plugin settings. Support for ...

    • Adobe Commerce

      Live Payments Setup for Adobe Commerce Overview This document provides installation and configuration guidance for merchants using Adobe Commerce with the Cybersource payment gateway, via Live Payments. Please note that Adobe Commerce is different ...

    • Shopify

      Shopify Boarding Guide with CyberSource app Overview The CyberSource payment app for Shopify enables you to accept Unified Checkout payments directly in your online store, including card payments and supported digital wallets (such as Apple Pay, and ...