Prerequisites
- WordPress 5.8 or higher
- WooCommerce 8.0 or higher
- PHP 7.4 or higher
- An AcountPay merchant account with a Client ID
Step 1: Get your Client ID
Log in to the Merchant Dashboard
Go to merchant.acountpay.com and sign in with your merchant account.
The same Client ID works for both test and live modes. You switch between modes in the plugin settings.
Step 2: Install the plugin
Download the plugin
Download the plugin ZIP from the AcountPay WooCommerce GitHub repository. Click Code > Download ZIP, or download directly: Download ZIP.
Upload to WordPress
In your WordPress admin panel, go to Plugins > Add New > Upload Plugin. Choose the downloaded ZIP file and click Install Now.
Step 3: Configure the gateway
Enter your settings
Configure the following fields:
| Setting | Value |
|---|---|
| Enable/Disable | Check to enable |
| Payment Mode | Test for testing, Live for real payments |
| Client ID | Paste the Client ID from the Merchant Dashboard |
| API Base URL | Leave as default (https://api.acountpay.com) |
| Title | Display name at checkout (e.g. “Pay with AcountPay”) |
| Description | Short text shown under the payment method |
| Enable Logging | Enable during testing for debugging |
| SSL Verification | Keep enabled for production |
Step 4: Test a payment
Place a test order
Add a product to the cart, go to Checkout, and select AcountPay as the payment method.
Complete the payment
You will be redirected to AcountPay to select your bank and authorize the payment. After completing the payment, you are returned to your store’s order confirmation page.
Step 5: Go live
Once testing is successful:- Go to WooCommerce > Settings > Payments > AcountPay Payment Gateway.
- Change Payment Mode to Live.
- Click Save changes.
How it works
Troubleshooting
Payment method not appearing at checkout
Payment method not appearing at checkout
- Verify the plugin is activated in Plugins.
- Check that Enable/Disable is checked in the gateway settings.
- Ensure WooCommerce is active and your store has at least one product.
Payment fails or shows an error
Payment fails or shows an error
- Enable Enable Logging in the gateway settings.
- Check logs at WooCommerce > Status > Logs and filter for
acountpay-payment. - Verify your Client ID is correct.
- Ensure the API Base URL is
https://api.acountpay.com.
Order stuck on 'On Hold'
Order stuck on 'On Hold'
The webhook from AcountPay may not have arrived yet. This can happen if:
- Your site is not publicly accessible (e.g. running on localhost). Webhooks require a public URL.
- A firewall is blocking incoming requests from AcountPay.
SSL certificate errors
SSL certificate errors
If you see SSL errors in the logs, you can temporarily disable SSL Verification in the gateway settings for testing. Keep it enabled in production.
Settings reference
| Setting | Description | Default |
|---|---|---|
| Enable/Disable | Enable the AcountPay gateway | Disabled |
| Payment Mode | Test or Live | Test |
| Title | Label shown at checkout | AcountPay Payment Gateway |
| Description | Text shown under the payment method | Pay securely using your bank account via AcountPay Payment Gateway. |
| Client ID | Your Client ID from merchant.acountpay.com | — |
| API Base URL | AcountPay API endpoint | https://api.acountpay.com |
| Enable Logging | Log API requests/responses for debugging | Disabled |
| SSL Verification | Verify SSL certificates on API calls | Enabled |
| Redirect URL | Custom post-payment redirect (optional) | Order received page |

