內容簡介
總結：這是一個安全的支付網關外掛插件，用於將 GetPay 支付系統與 WooCommerce 整合，適用於 WordPress 電子商務商店。
1. 什麼是 GetPay WooCommerce 整合的主要目的？
- 將 GetPay 支付系統與 WooCommerce 擴展整合以增加安全的支付功能。
2. 在安裝 GetPay 插件之前需要哪些先決條件？
- 需要擁有具有管理訪問權限的 WordPress 網站。
- 需要安裝並啟用 WooCommerce 外掛。
- 需要擁有 GetPay 商戶帳戶（從您的銀行獲取憑證）。
- 建議安裝 SSL 憑證以增加安全性。
3. 如何設置 GetPay 的必填字段？
- 進入 WooCommerce > 設置 > 付款，點擊 GetPay Gateway，然後點擊管理或設定。
- 在設定區域輸入必填字段，包括啟用、標題、PAP 資訊、OPR 金鑰、網站域名等，並點擊保存更改。
4. 如何設置頁面以使 GetPay 可以正常運作？
- 創建購物車頁面、結帳頁面和支付成功頁面，並添加相應的短代碼和 URL，保證與 GetPay 插件設置中的成功 URL 一致。
5. 如何進行測試和疑難排解？
- 在安裝和設置完成後，進行支付測試以確保一切運作正常。
- 如果遇到問題，可以查看疑難排解部分獲取支援或協助解決。
6. 安全性注意事項和更新內容？
- 在使用 GetPay 外掛時，注意保護網站安全，並及時查看更新內容以確保插件功能的最新和安全性調整。
外掛標籤
開發者團隊
原文外掛簡介
A secure payment gateway plugin for WooCommerce using GetPay.
GetPay WooCommerce Integration
A secure payment gateway plugin that integrates the GetPay payment system with WooCommerce for WordPress e-commerce stores.
Table of Contents
Prerequisites
Installation
Configuration
Page Setup
Testing
Troubleshooting
Support
Security Notes
Changelog
Prerequisites
Before installing the GetPay plugin, ensure you have:
✅ WordPress site with admin access
✅ WooCommerce plugin installed and activated
✅ GetPay merchant account (credentials from your bank)
✅ SSL certificate installed (recommended for security)
Configuration
Step 1: Access Payment Settings
Navigate to WooCommerce > Settings > Payments
Locate GetPay Gateway in the list
Click Manage or Set up
Step 2: Configure Required Fields
Field
Description
Example
Enable
Check to activate GetPay
☑️
Title
Customer-facing payment title
GetPay
PAP Info
Payment Application Provider info (from bank)
eyJpbn...
OPR Key
Operational key
4fa4c6b9-...
INS Key
Institution key (if any)
(blank)
Website Domain
Your site domain (with HTTPS)
https://your-site.com
Bundle JS URL
GetPay JS bundle
https://minio.finpos.global/.../bundle.min.js
Success URL
Redirect on successful payment
https://your-site.com/success
Fail URL
Redirect on failed payment
https://your-site.com/fail
Base URL
GetPay API base endpoint
https://uat-bank-getpay.nchl.com.np/...
Click Save Changes
Page Setup
Step 1: Create Pages
Create the following pages via Pages > Add New:
🛒 Cart Page
Title: Cart
Content: [woocommerce_cart]
💳 Checkout Page
Title: Checkout
Content: [woocommerce_checkout]
💰 Payment Page
Title: Payment
Content: Add the following HTML tag to embed the payment interface:
Purpose: This page serves as the payment processing screen where the GetPay JS bundle will render the secure payment interface.
✅ Success Page
Title: Payment Success
Content: Add the following shortcode in the content area of the page:
[getpay_check_success_page]
URL: The page URL must exactly match the Success URL you have configured in the GetPay plugin settings (e.g., https://your-site.com/success).
Custom Content: You may add additional messages, images, or layout elements after the shortcode if needed. However, do not remove or modify the shortcode, as it is essential for validating and displaying the payment confirmation.
❌ Failure Page
Title: Payment Failed
Content: You can display a custom message such as: [getpay_check_fail_page]
URL: The page URL must exactly match the Fail URL you have configured in the GetPay plugin settings (e.g., https://your-site.com/fail).
Custom Content: You may customize the message or design of this page to fit your site’s branding, but make sure the URL is correct to ensure users are properly redirected after a failed transaction.
Step 2: Assign Pages in WooCommerce
Go to WooCommerce > Settings > Advanced
Set:
Cart page: Cart
Checkout page: Checkout
Click Save Changes
Testing
Test Mode
Use sandbox credentials from your bank
Test with provided test card numbers
Verify flows: ✅ success, ❌ failure, ✋ cancellation
Live Mode
Replace test keys with production credentials
Update Base URL to production endpoint
Run small-amount test transactions before going live
Troubleshooting
Plugin Not Appearing
Ensure WooCommerce is activated
Check if GetPay plugin is active
Verify GetPay Gateway is enabled under payment methods
Payment Failures
Double-check PAP/OPR/INS credentials
Ensure site has valid SSL
Check if JS bundle and API endpoints are accessible
Redirect Issues
Make sure success/fail URLs are correct
Pages should be published and match settings
Debug Logs
Go to WooCommerce > Status > Logs
Check logs prefixed with getpay
Look for API errors or response messages
Support
🛠️ Plugin Issues
Contact your plugin development team
🏦 Payment Issues
Contact your bank’s GetPay support team
📖 WooCommerce
Refer to WooCommerce documentation
Security Notes
🔒 Always use HTTPS in production
🔁 Keep plugin updated
💾 Regularly back up your site
🔐 Never share your credentials publicly
🧪 Fully test before enabling live payments
