PlanetPay integration
The PlanetPay module integrates WooCommerce with the PlanetPay payment gateway. It supports BLIK, payment cards, bank transfers, Google Pay and Apple Pay.
Configuration
Section titled “Configuration”Go to WooCommerce > Settings > Payments > PlanetPay.
Access credentials
Section titled “Access credentials”| Setting | Description |
|---|---|
| Merchant ID | Merchant identifier |
| Merchant Secret | Merchant secret key |
| Signing key | SHA256 HMAC key for verifying webhooks |
| Sandbox mode | Testing without real transactions |
Payment methods
Section titled “Payment methods”| Method | Description |
|---|---|
| BLIK | Payment with a 6-digit code, instant |
| Cards | Visa, Mastercard, others |
| Bank transfers | Przelewy24 and traditional transfers |
| Google Pay | Google Pay payment |
| Apple Pay | Apple Pay payment |
Payment flow
Section titled “Payment flow”- The customer selects BLIK and enters a 6-digit code
- The payment is processed instantly through the API
- The order is marked as paid
Other methods
Section titled “Other methods”- The customer selects a payment method
- Redirect to the PlanetPay paywall
- A webhook updates the order status
Refunds
Section titled “Refunds”Refunds can be initiated from the WooCommerce order panel. The PlanetPay API processes the refund and sends a webhook notification.
Webhooks
Section titled “Webhooks”| Endpoint | Description |
|---|---|
/wp-json/polski-pro/v1/planetpay/payment | Payment status notifications |
/wp-json/polski-pro/v1/planetpay/refund | Refund status notifications |
Webhooks are verified with a SHA256 HMAC signature in the X-Planetpay-Signature header.