GiveWP
Integrate the HitPay payment gateway into your GiveWP forms
Account Setup
Before you begin integrating HitPay payments into your WordPress store, you need to set up your HitPay account and ensure some prerequisites are met:
- If you haven’t already, create an account on HitPay.
- Ensure that you have the necessary payment methods activated in your HitPay account.
- Make sure the payment methods you want to offer are enabled in your WordPress sales channel.
Description
The HitPay Payment Gateway for GiveWP allows merchants to accept donations through various payment methods including PayNow QR, Cards, Apple Pay, Google Pay, WeChatPay, AliPay, and GrabPay. This plugin interfaces with HitPay, a third-party payment gateway, to process these payments efficiently.
Merchants must first create an account with HitPay and choose their desired payment options via the HitPay dashboard. API keys and Salt values must be retrieved from the HitPay Web Dashboard under Settings > Payment Gateway > API Keys.
There are no monthly, setup, admin, or hidden service fees, as merchants pay only per transaction.
Installation
- Navigate to the ‘Add New’ in the plugins dashboard.
- Navigate to the ‘Upload’ area.
- Download the latest zip file from here: https://github.com/hit-pay/givewp/tags
- Select
hitpay-payment-gateway-for-givewp.zipfrom your computer. - Click ‘Install Now’.
- Activate the plugin in the Plugin dashboard.
Using FTP
- Download
hitpay-payment-gateway-for-givewp.zip. - Extract the directory to your computer.
- Upload the directory to the
/wp-content/plugins/directory. - Activate the plugin in the Plugin dashboard.
Configuration
Access Donations Settings
Go to Donations settings.
Select Payment Gateways
Select the “Payment Gateways” tab.
Activate Payment Method
Activate the payment method (if inactive) in the Option-Based Form Editor by ticking the Enabled checkbox field.
Set Display Name
Set the name you wish to show your users on Checkout (for example: “Creditcard or PayNow”).
Configure HitPay Gateway
Click the link ‘HitPay Payment Gateway’ under the tabs. Copy and paste the API keys and Salt values from the HitPay settings.
Save Changes
Click “Save Changes”.
Select Payment Methods in HitPay
Navigate back to the HitPay dashboard, go to “Plugin Integration” > “Create New Integration” > “WooCommerce Plugin,” and select your payment methods.
Donation
Navigate to Donation Page
Direct donors to the donation page on your website.
Select Donation Amount
Donors choose their donation amount and select their preferred payment method.
Complete Payment
Donors complete their payment using their selected method.
Refunds
Log in to Admin Panel
Log in to your admin panel to manage donations.
Navigate to Donations
Navigate to Donations ⇒ Donations.
Edit Donation Details
Click the edit link to navigate to the Donation Payment Details page.
Process Refund
If the donation is paid via ‘HitPay Payment Gateway’, then the ‘Refund via HitPay Payment Gateway’ button will be displayed. Click this button to process the refund.
Confirm Refund
Confirm the refund details which will be added to the donation payment note. Note that only one refund is allowed per transaction.
FAQs
I have completed the plugin setup but I am unable to proceed to the payments page
I have completed the plugin setup but I am unable to proceed to the payments page
If you have completed the plugin installation and if you still see an error message Something went wrong please contact the merchant on the checkout page, please make sure to check the following:
- In your plugin settings, ensure it's not in test mode (
Live Modeshould be enabled). - Make sure that the
API KeyandSaltValue are correct. You can find them in your dashboard under the "API Keys" Menu https://dashboard.hit-pay.com/. - Ensure that the store
checkout currencyis supported by your account. Click here for more details on the currencies supported. Minimum amountfor each payment method could be different, please ensure that the checkout amount is above the minimum amount.
If you still face an error after this, make sure to capture the error logs from your commerce store and contact our support team at support@hit-pay.com.
Does HitPay send an email after the WordPress order is confirmed
Does HitPay send an email after the WordPress order is confirmed
No, HitPay does not send an email confirmation to your customer if the payment is made through WordPress. This is because WordPress, by default, sends an email to your customer with the order details. To prevent duplicate emails, HitPay does not send an additional email to your customers. As a merchant, you will receive a payment alert email.
Why does my charges `webhook status` show as failed?
Why does my charges `webhook status` show as failed?
If you are using a payment plugin, after every successful payment, a webhook is sent to your store to acknowledge the payment confirmation. Your order is marked as paid through this webhook.
A webhook status showing as "failed" indicates that Hitpay failed to communicate with your server. This can happen for the following reasons:
- Your store may have a security feature that blocked Hitpay's request.
- Your server was unavailable during this time.
To avoid this issue, ensure that you whitelist Hitpay's IP addresses:
- Production:
3.1.13.32,52.77.254.34 - Sandbox:
54.179.156.147
For further details, please review your store's debug logs.
How do I send WordPress test store access to HitPay?
How do I send WordPress test store access to HitPay?
If you are unable to resolve the WordPress issues, you can request HitPay support to help with your debugging. But before that, make sure the following checks are completed:
- Ensure that your credentials are correct, both the API Key and Salt.
- Ensure that you are testing with an amount greater than $1 (or equivalent).
- Make sure the webhook in the HitPay dashboard shows “Success.” Please provide the following details to the HitPay team:
- Debug logs from your WordPress store.
- Admin access to your WordPress test store (Since our team will be debugging, please avoid sending access to your live store).
- SFTP access to your test store. You can send the details to support@hit-pay.com (Approximate debug time would be 3 to 5 business days).
Why don't I see Apple Pay or Google Pay on my checkout page?
Why don't I see Apple Pay or Google Pay on my checkout page?
On the HitPay checkout page, you will see the option for Apple Pay/Google Pay only once you select CARDS as the payment method.
Additionally, it will work only if the browser supports the respective method:
Apple Pay: Only available on the Safari browser. Ensure you have Apple Pay enabled. Here's a guide from Apple on how to enable Apple Pay on your browser.Google Pay: Only available on the Chrome browser. Ensure you have Google Pay enabled on your Google account.
I set up a payment method, but it's not reflecting on my checkout page. Why?
I set up a payment method, but it's not reflecting on my checkout page. Why?
Here are two checks you can perform to ensure the payment method is visible on your checkout page:
- Navigate to
Payment Gateway>Integrations. Ensure that your payment method is enabled for your respective sales channel. - If you have checkout rules, navigate to
Payment Gateway>Checkout Customization>Payment Method Rulesand ensure your payment method is selected.