The Visa Acceptance Solutions payment plugin for WooCommerce allows merchants to connect their WooCommerce store to the Visa Acceptance Platform to directly take credit/debit card, Apple Pay, Google Pay, and Click to Pay payments.
Supported Features
↑ Back to top- Credit/Debit card payments
- Click to Pay
- Apple Pay
- Google Pay
- Payer Authentication / 3D-Secure
- Tokenization
- Fraud Screening with Cybersource Decision Manager or Fraud Management Essentials
We also work with the following WooCommerce features:
Supported Versions
↑ Back to topOur WooCommerce plugin requires the following:
- WooCommerce 7.6+
- WordPress 6.5.3+
- PHP 8.0+ You can view your PHP version in the Server environment section under WooCommerce >Status.
Pre-Requisites
↑ Back to topMandatory
The following Visa Acceptance Solutions products must be enabled and configured for your transacting Merchant ID
- Unified Checkout
You must also have a REST Shared Secret Key
Optional
The following products are optional, but need to be enabled and configured for your Merchant ID if you choose to use them
- Payer Authentication for 3D-Secure
- Tokenization
- Click to Pay
- Apple Pay
- Google Pay
- Cybersource Decision Manager
- Cybersource Fraud Management Essentials
You can also choose to enable Message-Level Encryption (MLE) for additional security. A REST Certificate is required for MLE.
NOTE: If your Visa Acceptance Solutions account is managed by a merchant services provider, please refer to your providers documentation or support resources for account configuration/setup guidance, including key management.
Installation
↑ Back to topTo start using a product from WooCommerce.com, you can use the “Add to store” functionality on the order confirmation page or the My subscriptions section in your account.
- Navigate to My subscriptions.
- Find the Add to store button next to the product you’re planning to install.
- Follow the instructions on the screen, and the product will be automatically added to your store.
Alternative options and more information at:
Managing WooCommerce.com subscriptions.
If you want to install manually, see Install extensions or themes from WooCommerce.com
Configuration
↑ Back to topMinimum Configuration
The following need to be configured as a minimum to be able to accept payments with Visa Acceptance Solutions
Accepted Card Types: Select the card brands you want to accept.
Enable/Disable: Set to enable, the extension is active to take payments from your WooCommerce store. When enabled, card payments are enabled by default
Title: The text here will be displayed to your customers on the checkout and Order Received page
Description: The text here will be displayed during checkout
Transaction Type:
Charge will automatically capture the transaction if the authorization is approved
Authorization will only send an authorization request and if approved, you will need to manually request a capture
- Charge Virtual-Only Orders: If the order is exclusively for digital/virtual items, this setting will automatically capture the transaction if the authorization is approved
- Capture Paid Order: If you mark an order as Processing or Completed, capture requests will automatically be sent
Environment:
- Test for testing to your Visa Acceptance Solutions test account
- Production for live transactions
Merchant ID/Test Merchant ID: The transacting Merchant ID (MID) assigned to you by Visa Acceptance Solutions.
API Key Detail/Test API Key Detail: The Key from your REST API Shared Secret Key
API Shared Secret Key/Test API Shared Secret Key: The Shared Secret from your REST API Shared Secret Key
Message Level Encryption
Message-Level Encryption (MLE) enables you to store information or communicate with other parties while helping to prevent uninvolved parties from understanding the stored information. MLE is optional and supported only for payments services. A REST Certificate is required for MLE
To enable MLE, perform the following steps:
- Click Enable Message Level Encryption
- Enter the Key Directory Path where you have stored the key in your WooCommerce environment
- Enter the Key File Name
- Enter the Key Password which you set when generating the REST Certificate
Digital Payment Methods
Choose from Click to Pay, Apple Pay and Google Pay
NOTE: You must enable this for your MID. Please see this guide for details or contact your merchant services provider.
Tokenization
Tokenisation allows you to offer the ability for your customers to save their payment cards securely for future payments.
Tick Tokenization to enable
Saved Card Verification: Tick this to request customers enter their Card Security Code when paying with a saved card.
Payer Authentication / 3D-Secure
Tick Payer Authentication/3D Secure for added payment security. Some countries/regions mandate this.
Strong Consumer Authentication: Tick this to force a 3D-Secure Challenge when a customer chooses to save their card for future transactions
Fraud Screening
Tick Fraud Screening to enable Decision Manager or Fraud Management Essentials.
NOTE: Fraud Screening profiles need to be setup in the Visa Acceptance Solutions Business Center, or with support from your merchant services provider
Additional Options
Debug Mode
- On: detailed logs will be created for every transaction. This is only recommended for the Test Environment or troubleshooting issues in Production
- Off: only basic logging is in place
Once you have configured the plug-in, please click Save Changes
Order Management
↑ Back to topOrders will be marked differently depending on the chosen Transaction Type
For Authorization, successful transactions will be marked as On Hold.
For Charge, successful transactions will be marked as Processing.
Fraud Screening
↑ Back to topIf fraud screening has been enabled, transactions will be marked as follows:
- Approved orders will be marked as On Hold or Processing, (depending on your Transaction Type setting)
- Orders to review will be marked as On Hold
- Rejected orders will be marked as Failed or Cancelled
Orders marked as On Hold will need to be reviewed in the Business Center. The Visa Acceptance Solutions extension will check for transaction status updates every 15 minutes. Rejected transactions will be marked as Cancelled.
Accepted transactions will be marked according to your Transaction Type settings
If you need to manually trigger the transaction update, please follow these steps in your WooCommerce Dashboard
- Go to Tools > Scheduled Actions > Pending
- Find and select wc_payment_gateway_update_order
- Click Apply
Capture
↑ Back to topThere are two ways to capture an order if you have the Transaction Type set to Authorization. Enter the order from the list of orders and choose one of the following:
- Click the Capture Charge button
- Change the order Status to Processing then click Apply
Refund
↑ Back to topTo refund an order, enter the order from the list of orders and follow these steps:
- Click the Refund button
- Enter the Refund Amount
- Click Refund via Visa Acceptance Solutions
Void
↑ Back to topVoids can only be performed for transactions where the Transaction Type is set to Authorization and the transaction has not yet been captured.
To void an authorization, perform the following steps:
- Click the Refund button
- Enter the Refund Amount
- Click Refund via Visa Acceptance Solutions
Testing
↑ Back to topTo test, configure the extension environment to Test. View our testing guide for test cases.
For testing 3D-Secure scenarios, please refer to this guide.
Frequently Asked Questions
↑ Back to topWhat do I need to know if I am migrating from another Cybersource WooCommerce plugin
Before installing this extension, you will need to deactivate the existing plugin as they both use the same underlying SDK and there will be conflicts. Please make a note of your existing configuration settings as these are not carried across.
NOTE: The information below applies to v2.0.0 and beyond of our plugin
If merchants have saved their payment cards on your WooCommerce website, those existing saved cards will continue to be available to use.
You will be able to Capture authorizations that took place on the other plug-in
You will not able to Refund transactions that took place on the other plug-in. For any transactions in this scenario, please log into the Visa Acceptance Solutions Business Center and refund the transaction there. You will need to manually update the order in WooCommerce.
For transactions that are marked as on hold because of Fraud Screening Review, you will need to manually cancel or capture the transaction in the Visa Acceptance Solutions Business Center, and manually update the order in WooCommerce.
If you need to rollback for any reason, please deactivate the Visa Acceptance Solutions plugin and then reactivate the other Cybersource plugin.
Support & Troubleshooting
↑ Back to topIf you require support with this extension, please sign into the Support Center to raise a case, providing the following details:
- Summary of the issue
- Steps needed to reproduce the issue
- Platform version
- Extension version
- Platform Merchant ID
- Configuration screenshots
- List of themes/additional extensions installed
- Log file and any other data or screenshots related to the issue
NOTE: If your Visa Acceptance Solutions Account is managed by a merchant services provider, please contact them for support in the first instance.
Upgrading
↑ Back to topIf you have installed the WooCommerce.com Update Manager, to upgrade to a later version of our WooCommerce extension, go to Extensions > Installed Extensions. Find Visa Acceptance Solutions and click update now.
If you are not using WooCommerce.com Update Manager, you will need to download the latest version and upload manually.
