{"id":1317,"date":"2026-07-08T09:27:15","date_gmt":"2026-07-08T09:27:15","guid":{"rendered":"https:\/\/easycommerce.dev\/docs\/?post_type=helpwp_doc&#038;p=1317"},"modified":"2026-07-08T09:27:15","modified_gmt":"2026-07-08T09:27:15","slug":"hitpay-payment-integration","status":"publish","type":"helpwp_doc","link":"https:\/\/easycommerce.dev\/docs\/addons\/hitpay-payment-integration\/","title":{"rendered":"HitPay Payment Integration"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">HitPay is a Singapore-native payment platform that lets your store accept the methods your customers already use every day, including P<strong>ayNow, GrabPay, cards, Apple Pay, Google Pay, WeChatPay, and AliPay<\/strong>. Integrating your HitPay account into your ecommerce website is seamless with the EasyCommerce payment gateway addon. Follow these simple steps for a smooth setup.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">To learn more about addons activation, read this documentation on <a href=\"https:\/\/easycommerce.dev\/docs\/addons\/install-and-activate-addons\/\" target=\"_blank\" rel=\"noreferrer noopener\"><strong>how to activate addons on EasyCommerce<\/strong><\/a>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Step 1: Navigate to Payment Settings<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Go to <strong>Store &gt; Settings &gt; Payment &gt; Methods<\/strong>.<\/li>\n\n\n\n<li>Select <strong>HitPay<\/strong> as your payment gateway.<\/li>\n\n\n\n<li>Tap &#8216;<strong>Save Settings<\/strong>&#8216; to finalize the changes.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Step 2: Enter Your HitPay Credentials<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Access the HitPay addon settings tab beside the &#8216;<strong>Methods<\/strong>&#8216; tab, then open the <strong>Credentials<\/strong> section.<\/li>\n\n\n\n<li>Log in to your <a href=\"https:\/\/dashboard.hit-pay.com\/\"><strong>HitPay Dashboard<\/strong><\/a> and copy your <strong>Business API Key<\/strong>.<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full has-custom-border\"><img loading=\"lazy\" decoding=\"async\" width=\"903\" height=\"554\" src=\"https:\/\/easycommerce.dev\/docs\/wp-content\/uploads\/2026\/07\/hitpay-api-key.png\" alt=\"\" class=\"has-border-color has-vivid-cyan-blue-border-color wp-image-1342\" style=\"border-width:4px;border-top-left-radius:5px;border-top-right-radius:5px;border-bottom-left-radius:5px;border-bottom-right-radius:5px\" srcset=\"https:\/\/easycommerce.dev\/docs\/wp-content\/uploads\/2026\/07\/hitpay-api-key.png 903w, https:\/\/easycommerce.dev\/docs\/wp-content\/uploads\/2026\/07\/hitpay-api-key-300x184.png 300w, https:\/\/easycommerce.dev\/docs\/wp-content\/uploads\/2026\/07\/hitpay-api-key-768x471.png 768w\" sizes=\"auto, (max-width: 903px) 100vw, 903px\" \/><\/figure>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Paste it into the <strong>Business API Key<\/strong> field.<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full has-custom-border\"><img loading=\"lazy\" decoding=\"async\" width=\"910\" height=\"455\" src=\"https:\/\/easycommerce.dev\/docs\/wp-content\/uploads\/2026\/07\/hitpay-business-api-key.png\" alt=\"\" class=\"has-border-color has-vivid-cyan-blue-border-color wp-image-1339\" style=\"border-width:4px;border-top-left-radius:5px;border-top-right-radius:5px;border-bottom-left-radius:5px;border-bottom-right-radius:5px\" srcset=\"https:\/\/easycommerce.dev\/docs\/wp-content\/uploads\/2026\/07\/hitpay-business-api-key.png 910w, https:\/\/easycommerce.dev\/docs\/wp-content\/uploads\/2026\/07\/hitpay-business-api-key-300x150.png 300w, https:\/\/easycommerce.dev\/docs\/wp-content\/uploads\/2026\/07\/hitpay-business-api-key-768x384.png 768w\" sizes=\"auto, (max-width: 910px) 100vw, 910px\" \/><\/figure>\n\n\n\n<ul class=\"wp-block-list\">\n<li>You&#8217;ll add the <strong>Webhook Salt<\/strong> in Step 4, once you&#8217;ve registered the webhook.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Step 3: Configure Basic and Checkout Settings<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">In the <strong>Basic<\/strong> section:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Enable &#8216;<strong>Sandbox Mode<\/strong>&#8216; (optional) to test against HitPay&#8217;s sandbox environment before going live.<\/li>\n\n\n\n<li>Upload a <strong>Payment Method Logo<\/strong> and set a custom <strong>Payment Method Name<\/strong> shown at checkout (optional).<\/li>\n\n\n\n<li>Choose the <strong>Default Order Status<\/strong> applied after a successful payment: Pending, Processing, or Completed.<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full has-custom-border\"><img loading=\"lazy\" decoding=\"async\" width=\"1030\" height=\"790\" src=\"https:\/\/easycommerce.dev\/docs\/wp-content\/uploads\/2026\/07\/basic-settings.png\" alt=\"\" class=\"has-border-color wp-image-1340\" style=\"border-color:#0693e3;border-width:4px;border-top-left-radius:5px;border-top-right-radius:5px;border-bottom-left-radius:5px;border-bottom-right-radius:5px\" srcset=\"https:\/\/easycommerce.dev\/docs\/wp-content\/uploads\/2026\/07\/basic-settings.png 1030w, https:\/\/easycommerce.dev\/docs\/wp-content\/uploads\/2026\/07\/basic-settings-300x230.png 300w, https:\/\/easycommerce.dev\/docs\/wp-content\/uploads\/2026\/07\/basic-settings-1024x785.png 1024w, https:\/\/easycommerce.dev\/docs\/wp-content\/uploads\/2026\/07\/basic-settings-768x589.png 768w\" sizes=\"auto, (max-width: 1030px) 100vw, 1030px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">In the <strong>Checkout<\/strong> section:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Choose your <strong>Checkout Display<\/strong>:\n<ul class=\"wp-block-list\">\n<li><strong>Redirect<\/strong> (default) sends the customer to HitPay&#8217;s hosted payment page.<\/li>\n\n\n\n<li><strong>Drop-In<\/strong> opens HitPay&#8217;s payment UI in a modal directly on your checkout page, without a redirect. If you choose Drop-In, paste your <strong>Default Link<\/strong> from HitPay Dashboard &gt; Payment Links &gt; Default link into the <strong>Default Link<\/strong> field.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Processing Currency<\/strong> is fixed to SGD and cannot be changed. While HitPay is enabled, your store currency is overridden to SGD at checkout, since this is the only currency HitPay processes payments in.<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full has-custom-border\"><img loading=\"lazy\" decoding=\"async\" width=\"823\" height=\"507\" src=\"https:\/\/easycommerce.dev\/docs\/wp-content\/uploads\/2026\/07\/hitpay-checkout-settings.png\" alt=\"\" class=\"has-border-color wp-image-1341\" style=\"border-color:#0693e3;border-width:4px;border-top-left-radius:5px;border-top-right-radius:5px;border-bottom-left-radius:5px;border-bottom-right-radius:5px\" srcset=\"https:\/\/easycommerce.dev\/docs\/wp-content\/uploads\/2026\/07\/hitpay-checkout-settings.png 823w, https:\/\/easycommerce.dev\/docs\/wp-content\/uploads\/2026\/07\/hitpay-checkout-settings-300x185.png 300w, https:\/\/easycommerce.dev\/docs\/wp-content\/uploads\/2026\/07\/hitpay-checkout-settings-768x473.png 768w\" sizes=\"auto, (max-width: 823px) 100vw, 823px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Step 4: Register Your Webhook<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Webhooks let HitPay confirm completed payments and keep your order statuses in sync automatically.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Copy the webhook URL shown next to the <strong>Webhook Salt<\/strong> field in the Credentials section.<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full has-custom-border\"><img loading=\"lazy\" decoding=\"async\" width=\"903\" height=\"554\" src=\"https:\/\/easycommerce.dev\/docs\/wp-content\/uploads\/2026\/07\/hitpay-salt-key.png\" alt=\"\" class=\"has-border-color has-vivid-cyan-blue-border-color wp-image-1343\" style=\"border-width:4px;border-top-left-radius:5px;border-top-right-radius:5px;border-bottom-left-radius:5px;border-bottom-right-radius:5px\" srcset=\"https:\/\/easycommerce.dev\/docs\/wp-content\/uploads\/2026\/07\/hitpay-salt-key.png 903w, https:\/\/easycommerce.dev\/docs\/wp-content\/uploads\/2026\/07\/hitpay-salt-key-300x184.png 300w, https:\/\/easycommerce.dev\/docs\/wp-content\/uploads\/2026\/07\/hitpay-salt-key-768x471.png 768w\" sizes=\"auto, (max-width: 903px) 100vw, 903px\" \/><\/figure>\n\n\n\n<ul class=\"wp-block-list\">\n<li>In your HitPay Dashboard, go to <strong>Settings &gt; Payment Gateway<\/strong> and add this URL as your webhook endpoint.<\/li>\n\n\n\n<li>Copy the <strong>Webhook Salt<\/strong> HitPay gives you and paste it into the <strong>Webhook Salt<\/strong> field in the addon settings.<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full has-custom-border\"><img loading=\"lazy\" decoding=\"async\" width=\"810\" height=\"412\" src=\"https:\/\/easycommerce.dev\/docs\/wp-content\/uploads\/2026\/07\/paste-webhook-salt.png\" alt=\"\" class=\"has-border-color wp-image-1344\" style=\"border-color:#0693e3;border-width:4px;border-top-left-radius:5px;border-top-right-radius:5px;border-bottom-left-radius:5px;border-bottom-right-radius:5px\" srcset=\"https:\/\/easycommerce.dev\/docs\/wp-content\/uploads\/2026\/07\/paste-webhook-salt.png 810w, https:\/\/easycommerce.dev\/docs\/wp-content\/uploads\/2026\/07\/paste-webhook-salt-300x153.png 300w, https:\/\/easycommerce.dev\/docs\/wp-content\/uploads\/2026\/07\/paste-webhook-salt-768x391.png 768w\" sizes=\"auto, (max-width: 810px) 100vw, 810px\" \/><\/figure>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Tap &#8216;<strong>Save Settings<\/strong>&#8216; to store the changes.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Step 5: Test the Integration<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Keep &#8216;<strong>Sandbox Mode<\/strong>&#8216; enabled and use your HitPay sandbox credentials to run an end-to-end test.<\/li>\n\n\n\n<li>Place a test order and complete the payment on HitPay&#8217;s checkout page (or the Drop-In modal, if selected).<\/li>\n\n\n\n<li>Confirm the order returns to your store and updates to your chosen Default Order Status.<\/li>\n\n\n\n<li>Once testing is complete, disable Sandbox Mode and switch to your live credentials to start accepting real payments.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">How HitPay Payments Work on Your Store<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Available payment methods, <strong>PayNow, GrabPay, cards, Apple Pay, Google Pay, WeChatPay, and AliPay<\/strong>, are controlled by your HitPay account, not by the addon settings. The Payment Methods section in the addon simply lists what HitPay supports.<\/li>\n\n\n\n<li>Card and wallet details are handled entirely by HitPay&#8217;s hosted checkout or Drop-In modal, so sensitive payment data never touches your server.<\/li>\n\n\n\n<li>Every webhook notification is verified with an HMAC-SHA256 signature using your Webhook Salt before an order is touched, and repeated notifications never process the same order twice.<\/li>\n\n\n\n<li>Even if a webhook is delayed or blocked (for example, by a firewall), the addon also confirms the payment when the customer returns to your store after checkout, so orders don&#8217;t get stuck as pending.<\/li>\n\n\n\n<li>You can issue full or partial refunds straight from the EasyCommerce order screen. Refunds are sent to HitPay and recorded against the original payment.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Note:<\/strong> This addon requires the EasyCommerce plugin to be installed and active, plus a HitPay account with a Business API Key and Webhook Salt. Payments are processed in Singapore Dollars (SGD) while the gateway is enabled.<\/p>\n","protected":false},"author":6,"featured_media":0,"template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}}},"helpwp_product":[19],"helpwp_topic":[21],"class_list":["post-1317","helpwp_doc","type-helpwp_doc","status-publish","hentry","helpwp_topic-addons"],"_links":{"self":[{"href":"https:\/\/easycommerce.dev\/docs\/wp-json\/wp\/v2\/helpwp_doc\/1317","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/easycommerce.dev\/docs\/wp-json\/wp\/v2\/helpwp_doc"}],"about":[{"href":"https:\/\/easycommerce.dev\/docs\/wp-json\/wp\/v2\/types\/helpwp_doc"}],"author":[{"embeddable":true,"href":"https:\/\/easycommerce.dev\/docs\/wp-json\/wp\/v2\/users\/6"}],"wp:attachment":[{"href":"https:\/\/easycommerce.dev\/docs\/wp-json\/wp\/v2\/media?parent=1317"}],"wp:term":[{"taxonomy":"helpwp_product","embeddable":true,"href":"https:\/\/easycommerce.dev\/docs\/wp-json\/wp\/v2\/helpwp_product?post=1317"},{"taxonomy":"helpwp_topic","embeddable":true,"href":"https:\/\/easycommerce.dev\/docs\/wp-json\/wp\/v2\/helpwp_topic?post=1317"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}