WooCommerce Liberty PAY Payment Gateway
Documentation for the Plug and Pay WooCommerce Liberty PAY Payment Gateway plugin.
Requirements
Technical Requirements
- PHP: 7.4, 8.1, 8.2, or 8.3
- ionCube Loader: Required. For version requirements and installation details, check the IonCube Loader documentation.
- WooCommerce: 3.0.0 or higher
Store Setup Prerequisites
- Liberty PAY Credentials: Merchant ID and Merchant Password.
Technical Specification & Feature Support
| Feature | Supported |
|---|---|
| Blocks Support | No |
| HPOS | Yes |
| Background Polling | No |
| Callback (Async) | Yes |
| Redirect Sync | No |
| Saved Cards | No |
| Add Cards from My Account | No |
| Subscriptions | No |
| Manual Authorization | No |
| Refunds | Yes |
| Multi-Currency | No |
| Apple Pay | No |
| Google Pay | No |
| Test Mode | Yes |
Technical Details
Callback (Async Notification)
Liberty PAY sends the final payment result to the callback URL generated by the plugin. The plugin validates the notification and completes the WooCommerce order when the payment succeeds.
Redirect Sync
The customer return routes validate Liberty PAY's signed response but do not request the current payment status from the provider. A successful return places the order on hold until the asynchronous callback confirms payment.
HTTP Callback Fallback
Callback URLs use HTTPS by default. Enable HTTP callbacks only if Liberty PAY cannot reach your HTTPS callback URLs. The store must accept HTTP requests without automatically redirecting them to HTTPS.
Configuration
Go to WooCommerce > Settings > Payments > Liberty PAY and configure:
- Enable Liberty PAY
- Title, Description, and Order button text
- Test mode
- HTTP callbacks, only when Liberty cannot reach HTTPS callbacks from your store
- Debug log
- Merchant id
- Password
The gateway shows the success, error, cancel, and callback URLs in its settings screen. Provide those URLs to Liberty PAY when configuring the merchant account.