README

The VR Payment plugin wraps around the VR Payment API. This library facilitates your interaction with various services such as transactions. Please note that this plugin is for versions 6.5, 6.6 or 6.7. For the 6.4 plugin please visit our Shopware 6.4 plugin.

Requirements

Shopware 6.7.x, 6.6.x or 6.5.x. See table below.
PHP minimum version supported by the each shop version.

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)

Navigate to your Shopware root directory.
Run:

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

Manual Installation

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

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

Configuration

API Credentials

Navigate to Shopware Admin > Settings > VRPayment Payment.
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.

Subscriptions: Make recurring payments with Subscriptions (Shopware Commercial) and VRPayment.

Compatibiliity

Shopware 6 version	Plugin major version	Supported until
Shopware 6.7.x	7.x	Further notice
Shopware 6.6.x	6.x	December 2025
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.

vrpayment / shopware-6

Maintainers

Details