Integrating PublicSquare Payments with WooCommerce

PublicSquare WooCommerce Payments Plugin is a 1-click plugin for WooCommerce that allows you to accept credit and debit card payments instantly.

Before You Begin

This SDK requires the use of a Publishable API Key. Go to your Developers section and click Reveal for your Publishable Key and Secret Key copy these values.

If you have not yet created an account, schedule a demo with our team to get started.

Installation

This guide will walk you through setting up the PublicSquare Payments app in WooCommerce. Follow the steps below carefully to ensure a smooth installation and configuration process.

Step 1: Upload and Activate the Plugin

1. Download the Plugin

   • You will receive a .zip file containing the PublicSquare Payments plugin

2. Log in to Your WordPress Admin Dashboard

   • Navigate to your website's WordPress Admin dashboard

3. Go to Installed Plugins
   • Click on Plugins in the sidebar, then select Add New

4. Upload the Plugin
   • Click Upload Plugin at the top of the page
   • Click Choose File and select the .zip file provided
   • Click Install Now to install the plugin

Choose File

Install Now

5. Activate the Plugin
   • Once installed, click Activate to enable the plugin on your site

6. Plugins page

• You should see the PublicSquare Payments plugin listed and activated under Installed Plugins

Step 2: Configure Payment Settings in WooCommerce

1. Navigate to Payment Settings
   • Go to WooCommerce > Settings > Payments
   • If it is not Enabled click on Enable
   • Click on Manage

2. Enter configuration data

Field	Description
Title	This text will be shown to the customer at checkout.	Defaults to "Credit/Debit Card"
Description	This text will appear below the payment title during checkout.	Defaults to "Pay with your debit or credit card."
PublicSquare Public API Key	The public API key that is used by the PublicSquare credit card form.	Obtain your Public API Key from the PublicSquare Portal
PublicSquare Secret API Key	The secret API key that is used by the PublicSquare credit card form.	Obtain your Secret API Key from the PublicSquare Portal

3. Click the Save Changes button to apply the settings

Step 3: Test the Payment Gateway

1. Place a Test Order

   • Add a product to the cart on your site and proceed to checkout
   • Use the PublicSquare payment method to place a test order

2. Verify Transactions

   • Confirm that the payment has been processed successfully and is visible in WooCommerce and in the PublicSquare Portal

3. Check Email Notifications

   • Ensure that both customer and admin emails for the order are being sent correctly

Testing Cards

For testing purposes, refer to the PublicSquare Testing Cards Documentation. This resource provides card details for simulating different scenarios in a test environment.

Additional Notes

• If you encounter any issues during installation or setup, refer to the FAQ section below or contact PublicSquare support for assistance
• Ensure that your WooCommerce site is running the latest version to avoid compatibility issues
• Verify that your server meets the plugin's minimum requirements (PHP version 7.4+ and WordPress version 5.6+)

FAQs

1. Where do I find my PublicSquare API Keys?

   • Log in to the PublicSquare Portal, navigate to the API section, and generate your Public and Secret API keys

2. What should I do if payments fail?

   • Check the error message displayed on the checkout page.
   • Verify that your API keys are correct and have the necessary permissions.
   • Contact PublicSquare support if the issue persists.

3. Can I customize the payment title or description?

   • Yes, you can modify these fields in the WooCommerce payment settings under PublicSquare Payments.

4. What testing environment is available for this plugin?

   • You can test payments using the PublicSquare test environment.
   • Use the PublicSquare Testing Cards to simulate various payment scenarios, such as succeeded transactions, declined cards, or errors.

5. How do I troubleshoot if payments don't appear in the PublicSquare Portal?

   • Verify that the API keys in the WooCommerce settings are correct.
   • Ensure your site has a stable internet connection during the payment process.
   • Check your WooCommerce logs (WooCommerce > Status > Logs) for any error messages related to the payment gateway.

6. How do I update the plugin to the latest version?

   • Download the updated .zip file from PublicSquare.
   • Follow the same steps to install the plugin above, the activate page will show the new and existing plugin versions.
   • Clicking Activate in step 5. will overwrite your existing version.
   • Your existing settings will not be affected.

7. Does this plugin support refunds?

   • Yes, refunds can be processed directly from the WooCommerce dashboard.
   • Navigate to the order details page, and click Refund to initiate a partial or full refund. The refund will also reflect in the PublicSquare Portal.

8. Is there a fee for processing payments with PublicSquare?.

   • Processing fees depend on the PublicSquare payment gateway terms. Refer to the fee structure in your PublicSquare Portal account or contact support for details.

Support

If you have questions or run into any issues, please email our support team at payment-support@publicsq.com.