README

Cybersource Payment

Introduction

The Cybersource plugin enables secure credit card payments in Shopware stores. It integrates with Cybersource's payment gateway to process transactions, supports guest checkouts, and allows returning customers to save their card details for faster purchases. The plugin provides real-time transaction tracking, PCI compliance, and flexible refund options.

Key Features

Secure Transactions
- PCI-compliant payments with real-time fraud protection.
Multiple Payment Modes
- Choose between Auth Only or Auth & Capture.
Guest Checkout Support
- Accept credit card payments without requiring customer accounts.
Saved Payment Methods
- Returning customers can save cards for faster checkout.
Transaction Management
- View and manage transactions directly in Shopware admin.
Flexible Refund Options
- Process full or partial refunds with ease.
Multi-Store Compatibility
- Works across multiple Shopware instances.

Get Started

Installation & Activation

Download

Git

Clone the Plugin Repository:

git clone https://github.com/solution25com/cybersource-payment-shopware-6-solution25.git

Packagist

 composer require solution25/cybersource

Install the Plugin in Shopware 6

Log in to your Shopware 6 Administration panel.
Navigate to Extensions > My Extensions.
Locate the Cybersource plugin and click Install.

Activate the Plugin

After installation, click Activate to enable the plugin.
In your Shopware Admin, go to Settings > Shop > Payment Methods.
Check if the "Cybersource Payment" is active and make sure it's also added to the sales channels.

Verify Installation

After activation, you will see Cybersource Payment in the list of installed plugins.
The plugin name, version, and installation date should appear as shown in the screenshot below.

Plugin Configuration

1. Access Plugin Settings

Go to Extensions > My Extensions.
Locate Cybersource Payment and click configure to open the plugin settings.

2. General Settings

Sales Channel

Select the sales channel(s) where you want Cybersource to be active.

Environment

You can switch to Production environment or not .

Live Account Keys

Enter the organization ID , access KEY and the share product Key

Sanbox Account Keys

Enter the organization ID , access KEY and the share product Key for the sandbox account keys.

Transaction Type

Choose between Auth Only or Auth & Capture.

3D Secure

You can enable 3ds.

3. Save Configuration

Click Save in the top-right corner to store your settings.

Webhook Usages

Webhooks will install automatically when you active the plugin.
Also you can manage webhooks using the command line interface (CLI) commands provided by the plugin. These commands allow you to create, read, update, and delete webhooks as needed.

bin/console cybersource:create-webhook

bin/console cybersource:read-webhook

bin/console cybersource:update-status-webhook --active=true

bin/console cybersource:delete-webhook

Troubleshooting

If you encounter any issues during installation or configuration, please check the following:
- Ensure that your Shopware version is compatible with the plugin.
- Verify that all required fields in the plugin settings are filled out correctly.
- Check your server logs for any error messages related to the plugin.
- Make sure to use HTTPS

FAQ

How can I configure custom fraud validation rules in CyberSource?

If you're facing transaction issues due to fraud validation (e.g. CVV mismatch, AVS mismatch), these settings can be reviewed and configured in your CyberSource Business Center.

Steps to Configure Custom Fraud Rules:

Log in to your CyberSource account at: https://businesscentertest.cybersource.com/ebc2
Navigate to Fraud Management in the left-hand menu.
Go to Rule Configuration.
In the Standard Rules panel, you'll see predefined rules like:
- AVS Mismatch
- CVV Mismatch
- Invalid Address
- Billing-Shipping Mismatch
- Billing-IP Country Mismatch
Each rule can be set to one of the following:
- Monitor
- Reject
- Review
You can customize these rules based on your business needs. For example:
- Set "CVV Not Verifiable" to Reject to block transactions without valid CVV.
- Set "AVS Partial Match" to Disabled if you want to allow more leniency.

Every user or merchant can define their own fraud detection rules in this panel to control transaction flow and reduce false rejections.

Why is this important?

Many issues reported by customers regarding rejected payments are due to fraud rule settings. Ensuring these are configured appropriately helps reduce false positives and improves customer experience.

If you're unsure how to proceed, please contact your fraud management team or refer to CyberSource's official Fraud Management Guide (login may be required).

Support & Contact

For assistance with the Cybersource Payment plugin:

Email: info@solution25.com
Phone: +49 421 438 1919-0
Website: https://www.solution25.com
GitHub Repository: https://github.com/solution25com/cybersource-payment-shopware-6-solution25

solution25 / cybersource

Maintainers

Details