The WooCommerce Polar Payment Add-on enables seamless integration between your WooCommerce store and the Polar payment gateway. The add-on allows merchants to securely accept payments, manage transactions, and automatically update orders using Polar’s API and webhook system.
Customers can easily select Polar as their preferred payment method during checkout and complete their transactions securely. Customers can either complete their payment directly on the WooCommerce checkout page using the Embedded Payment feature or be redirected to the Polar-hosted payment page.
Installation
- Install and activate the WooCommerce plugin.
- Install and activate the WooCommerce Polar Payment Add-on.
- Navigate to WooCommerce > Settings > Payments.
License Settings
Go to the License Settings tab to add and activate the product’s License Key. License keys can be found in the email you received when you purchased the add-on. Add your license key in the corresponding field and click on Activate.
Payment Gateway Settings
All configuration for the Polar Payment Gateway is managed directly from: WooCommerce > Settings > Payments > Polar
Available Settings
- Enable/Disable
- Enable or disable Polar payments.
- Check “Enable Polar Payments” to activate.
- Title
- Defines the payment method title shown to customers on checkout.
- Example: Pay with Polar
- Description
- Description shown on checkout page.
- Example: You will be redirected to Polar to complete your payment.
- Product Name
- This defines the reference name of the transaction sent to Polar. It may also appear in order confirmation emails, helping customers identify their payment.
Embedded Payment
Enable this option to display the Polar payment form directly on the WooCommerce checkout page.
When enabled, customers can complete their payment without being redirected to the Polar-hosted payment page, resulting in a faster and more seamless checkout experience.
When disabled, customers will be redirected to the Polar payment page to complete their transaction and then returned to the Order Received (Thank You) page after successful payment.
- Test Mode
- Enable this option to process payments in the sandbox/testing environment.
- Polar Test OAT Token
- Required for testing transactions.
- This token can be generated from the Polar Sandbox account.
- Polar Live OAT Token
- Used for real (live) transactions after testing is completed.
How to Get Polar Test OAT Token
To test the payment gateway:
- Go to the Polar Sandbox website.
- Create your account or log in.
- Navigate to the Settings section.
- Scroll down and create your Test OAT Token.
- Copy and paste the token into the Polar Test OAT Token field in WooCommerce.
Checkout Experience & Payment Workflow
Once enabled, customers will see the Pay with Polar option on the checkout page, providing a clear and convenient payment choice.
The checkout experience depends on whether the Embedded Payment option is enabled or disabled.
Embedded Payment Enabled
When Embedded Payment is enabled, customers remain on the WooCommerce checkout page and complete their payment using the embedded Polar payment form.
The payment form is displayed directly within the checkout experience, allowing customers to enter their payment information without leaving your website.
After successful payment:
- The transaction is processed securely through Polar.
- Payment status is verified automatically.
- The WooCommerce order status is updated.
- The customer is redirected to the Order Received (Thank You) page.
Embedded Payment Disabled
When Embedded Payment is disabled, customers select Pay with Polar and click Place Order.
The system initiates the transaction and securely redirects the customer to the Polar-hosted payment page to complete the payment.
After successful payment:
- The transaction is processed securely through Polar.
- The customer is redirected back to the Order Received (Thank You) page.
- The WooCommerce order status is updated automatically.
Polar Payment User Interface
The WooCommerce Polar Payment Add-on supports both WooCommerce checkout experiences.
Classic Checkout Editor
When using the WooCommerce Classic Checkout experience, customers will see the Pay with Polar payment method within the standard payment methods section.
If Embedded Payment is enabled, the Polar payment form will appear directly within the checkout page.
Block Checkout Editor
When using the WooCommerce Checkout Block experience, customers will see the Pay with Polar option within the block-based payment methods section.
If Embedded Payment is enabled, the Polar payment form will appear directly within the checkout page without redirecting the customer away from your store.
Webhook Integration
The add-on includes webhook functionality to receive real-time events from Polar.
When a payment event occurs, Polar sends transaction updates to your WooCommerce store automatically.
The webhook system:
- Receives payment status updates in real time
- Updates WooCommerce order statuses automatically
- Maintains accurate transaction records
No manual intervention is required once webhooks are configured correctly.
Payment Confirmation Handling & Transaction Management
Payment status is verified automatically, and the WooCommerce order status is updated accordingly based on the transaction result. Order notes are also added for each update to maintain transparency. Additionally, all transactions are stored securely, allowing merchants to track payments, monitor transaction statuses, and maintain accurate records for future reference.
Switching to Live Mode
Once testing is completed successfully:
- Disable Test Mode
- Enter your Polar Live OAT Token
- Save changes
Note: Make sure all settings are correctly configured before switching to live mode.
FAQ’s
1. How do I enable the Polar payment gateway?
Go to WooCommerce > Settings > Payments, find the Polar Payment Gateway, and enable it. Then configure the required fields, like tokens, and save the settings.
2. Where can I get the Polar Test OAT Token?
You can generate the Test OAT Token from the Polar Sandbox website by creating an account and accessing the Settings section.
3. How do I switch from test mode to live mode?
Once testing is successful, disable Test Mode and replace the Test OAT Token with your Live OAT Token, then save the settings.
4. What happens after a successful payment?
After a successful transaction, the customer is redirected to the Order Received (Thank You) page, and the order status is updated automatically.
5. Are transactions automatically recorded?
All transactions are securely recorded, and order notes are added for each payment update, allowing you to track and manage payments.
6. What is the Embedded Payment feature?
The Embedded Payment feature allows customers to complete their payment directly on the WooCommerce checkout page without being redirected to the Polar-hosted payment page.
7. Do I need to enable Embedded Payment?
No. The feature is optional. If disabled, customers will be redirected to the Polar payment page to complete their payment.
8. Does Embedded Payment work with both Classic and Block checkout?
Yes. The WooCommerce Polar Payment Add-on supports both WooCommerce Classic Checkout and WooCommerce Checkout Block experiences.
9. Will customers be redirected when Embedded Payment is enabled?
No. Customers remain on the WooCommerce checkout page and complete their payment using the embedded Polar payment form.
10. Does the add-on support WooCommerce’s Add to Cart functionality?
Yes. The add-on fully supports WooCommerce’s default Add to Cart functionality. Customers can add single or multiple products to their cart and proceed through the standard WooCommerce checkout flow before selecting Pay with Polar during checkout.
Changelog’s
1.1.1
- Fixed minor security issues.
1.1.0
- New: Added support for Polar embedded checkout.
1.0.1
- Fixed a bug where the license activation was not working correctly.
1.0.0
- Initial release.
