PostPay — Austrian Post PostPay¶
Extension for Magento 2¶
User Manual¶
CopeX GmbH
Web: https://copex.io
Email: office@copex.io
Table of Contents¶
| Section | Page |
|---|---|
| 1 Requirements | 2 |
| 2 Configuration | 2 |
| 2.1 PostPay Settings | 2 |
| 3 Features | 3 |
| 3.1 PostPay as a Payment Method at Checkout | 3 |
| 3.2 Payment Instructions for Customers | 4 |
| 3.3 PostPay Refund | 4 |
| 4 Restrictions | 5 |
| 5 Troubleshooting | 5 |
1 Requirements¶
- Magento 2.3 or higher (compatible with 2.4)
- PHP 8.1 or higher
- Active PostPay contract with Austrian Post
- Recommended: CopeX PLC module for automatic PostPay refunds
2 Configuration¶
The module configuration is located in the Magento 2 backend under Stores > Configuration > Sales > Payment Methods > Post.at PostPay.
2.1 PostPay Settings¶
Navigate to Stores > Configuration > Sales > Payment Methods > Post.at PostPay.
- Enabled — Toggles PostPay as a payment method at checkout (Yes / No).
- Title — Name of the payment method shown in the checkout and order overview. Default:
Post Pay. - New Order Status — Order status set after placing an order with PostPay (e.g. Pending).
- Sort Order — Position of the payment method at checkout. Lower numbers appear first.
- PostPay Refund — Information block about the PostPay refund feature. The actual refund configuration is located in the CopeX PLC module under Stores > Configuration > Sales > Shipping Methods > PostPay Refund.
3 Features¶
3.1 PostPay as a Payment Method at Checkout¶
After activation, PostPay appears in the checkout as a selectable payment method. PostPay is an offline payment method — the actual payment processing happens directly between the customer and Austrian Post, not through an online gateway.
PostPay availability:
PostPay is available exclusively under the following conditions:
| Condition | Value |
|---|---|
| Country | Austria (AT) only |
| Currency | Euro (EUR) only |
| Maximum order value | 3,000 EUR |
| Virtual products | Not available (physical products only) |
These restrictions are hard-coded and cannot be changed via configuration.
Process:
- Customer selects PostPay at checkout.
- Order is placed with the configured initial status.
- Merchant creates a shipping label (recommended: CopeX PLC module).
- Package is dispatched as a PostPay shipment.
- Austrian Post collects the amount from the customer after delivery.
- Merchant receives the payment from Austrian Post.
3.2 Payment Instructions for Customers¶
The module shows customers appropriate payment instructions depending on the order status:
| Order status | Information shown |
|---|---|
| Default | Informational text about PostPay and a note that payment occurs after delivery |
| Canceled | Notice that the order has been canceled |
| Invoice created | Note about payment upon receipt of the shipment |
| Credit memo created | Note about the ongoing refund |
3.3 PostPay Refund¶
When both the PostPay module and the CopeX PLC module are installed, refunds can be processed automatically via the PostPay API.
Requirements: - CopeX PLC module installed and configured - PostPay API Key and API Secret entered in the PLC settings
Process: 1. Merchant creates a credit memo in Magento for a PostPay order. 2. The PLC module automatically sends a refund request to the PostPay API. 3. On success, an order comment is added. 4. On failure, the credit memo is not saved and an error message is displayed.
PostPay Refund configuration (API Key, API Secret) is done in the CopeX PLC module under Stores > Configuration > Sales > Shipping Methods > PostPay Refund.
4 Restrictions¶
- PostPay is available only for Austrian delivery addresses.
- Only Euro orders are supported.
- Carts containing only virtual products are not eligible.
- The maximum order value is limited to 3,000 EUR.
5 Troubleshooting¶
-
PostPay does not appear at checkout — Check that the module is enabled. Make sure the delivery address is in Austria and the order currency is Euro. Virtual products in the cart prevent PostPay from appearing.
-
PostPay Refund failed — Check the PostPay API credentials in the CopeX PLC module under Stores > Configuration > Sales > Shipping Methods > PostPay Refund. Make sure the PLC order number exists for this order.
-
Admin notification "CopeX PLC not installed" — If the PLC module is not installed, a daily admin notification appears. This notification indicates that PostPay Refund is not available. Install the CopeX PLC module to disable the notification.
License¶
Proprietary — CopeX GmbH. One license per production Magento instance. Test and development environments do not require an additional license.