archived-shopware-6/README.md

VR Payment Integration for Shopware 6

Overview

The VR Payment Payment Plugin integrates modern payment processing into Shopware 6, offering features like iFrame-based payments, refunds, captures, and PCI compliance. It supports seamless integration with the VR Payment Portal for managing transactions and payment methods.

Requirements

• Shopware Version: 6.5.x or 6.6.x (see compatibility table).
• PHP: Minimum version as required by your Shopware installation (e.g., 7.4+).
• VR Payment Account: Obtain Space ID, User ID, and API Key from the VR Payment Dashboard.

Documentation

• For English documentation click here
• Für die deutsche Dokumentation klicken Sie hier
• Pour la documentation Française, cliquez ici
• Per la documentazione in tedesco, clicca qui

Installation

Via Composer (Recommended)

1. Navigate to your Shopware root directory.
2. Run:

Copy
composer require vrpayment/shopware-6
php bin/console plugin:refresh
php bin/console plugin:install --activate --clearCache VRPaymentPayment

Manual Installation

1. Download the latest Release
2. Extract the ZIP to custom/plugins/VRPaymentPayment.

Copy
bin/console plugin:refresh  
bin/console plugin:install --activate --clearCache VRPaymentPayment  

Update

Via Administration

1. Go to Shopware Admin > Extensions > My extensions.
2. Find VRPaymentPayment.
3. Click Update.

Via CLI

1. Deploy the new plugin files (replace the folder in custom/plugins/VRPaymentPayment or upload/install a new ZIP).
2. Run:

bin/console plugin:refresh
bin/console plugin:update --clearCache VRPaymentPayment
bin/console cache:clear

Configuration

API Credentials

1. Navigate to Shopware Admin > Settings > VRPayment Payment.
2. Enter your Space ID, User ID, and API Key (obtained from the VR Payment Portal).

Payment Methods

Configure supported methods (e.g., credit cards, Apple Pay) via the VR Payment Portal.

Key Features

iFrame Integration: Embed payment forms directly into your checkout.

Refunds & Captures: Trigger full/partial refunds and captures from Shopware or the VR Payment Portal.

Multi-Store Support: Manage configurations across multiple stores.

Automatic Updates: Payment methods sync dynamically via the VRPayment API.

Compatibiliity

---

Shopware 6 version	Plugin major version	Supported until
Shopware 6.6.x	6.x	December 2026
Shopware 6.5.x	5.x	October 2024

---

Troubleshooting

Logs: Check payment logs with:

Copy
tail -f var/log/vrpayment_payment*.log

Common Issues:

Ensure composer update vrpayment/shopware-6 is run after updates.

Verify API credentials match your VRPayment account.

FAQs

Q: Does this plugin support one-click payments? A: Yes, via tokenization in the VRPayment Portal.

Q: How do I handle PCI compliance? A: The plugin uses iFrame integration, reducing PCI requirements to SAQ-A.

Changelog

For version-specific updates, see the GitHub Releases.

Contributing

Report issues via GitHub Issues.

Follow the Shopware Plugin Base Guide for development.

This template combines technical clarity with user-friendly guidance. For advanced customization (e.g., overriding templates or payment handlers), refer to the Shopware Documentation.

License

Please see the license file for more information.