README

The WeArePlanet plugin wraps around the WeArePlanet 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)

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

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

Manual Installation

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

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

Update

Via Administration

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

Via CLI

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

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

Configuration

API Credentials

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

WeArePlanet does not appear in Settings

1. You should run the following commmand

Copy
bin/build-administration.sh

Payment Methods

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

Key Features

iFrame Integration: Embed payment forms directly into your checkout.

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

Multi-Store Support: Manage configurations across multiple stores.

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

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

Compatibiliity

Troubleshooting

Logs: Check payment logs with:

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

Common Issues:

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

Verify API credentials match your WeArePlanet account.

FAQs

Q: Does this plugin support one-click payments? A: Yes, via tokenization in the WeArePlanet 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.