README

The PostFinance Checkout plugin wraps around the PostFinance Checkout 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 postfinancecheckout/shopware-6
php bin/console plugin:refresh
php bin/console plugin:install --activate --clearCache PostFinanceCheckout

Manual Installation

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

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

Update

Via Administration

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

Via CLI

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

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

Configuration

API Credentials

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

PostFinanceCheckout 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 PostFinance Checkout Portal.

Key Features

iFrame Integration: Embed payment forms directly into your checkout.

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

Multi-Store Support: Manage configurations across multiple stores.

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

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

Compatibiliity

Troubleshooting

Logs: Check payment logs with:

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

Common Issues:

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

Verify API credentials match your PostFinanceCheckout account.

FAQs

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