Description
Connects a WooCommerce store to the GamerHub merchant API and turns it into a fully automated game top-up / voucher shop.
- One-click catalog sync 鈥?every active GamerHub product becomes a WooCommerce product (variable product with one variation per denomination), priced at your cost + a markup you set.
- Player ID / Server fields on the product page, generated automatically from the game’s schema, with an optional live “Verify ID” check before purchase.
- Automatic fulfilment 鈥?when a WooCommerce order is paid, each unit is submitted to GamerHub server-side over an HMAC-signed request. One supplier order per unit, so every supplier and every quantity works.
- Signed status webhook 鈥?the order flips to Completed once GamerHub confirms delivery; voucher codes are attached to the order and emailed to the customer.
- Manual linking 鈥?hand-build any product (your own name / price / image) and link it to a GamerHub denomination.
- Auto-sync (optional) 鈥?refresh prices & stock hourly or daily in the background.
- HPOS compatible.
This plugin is an official client for the GamerHub merchant platform. A GamerHub merchant account is required.
External services
This plugin connects to the GamerHub merchant API (https://portal.gamerhubstore.shop) 鈥?the service it exists to integrate with. It communicates with that API in three situations:
- Catalog sync / price refresh 鈥?sends your API key (in signed request headers) and requests the product list and per-product prices. No customer data is sent.
- Order fulfilment 鈥?when a WooCommerce order is paid, the plugin sends the product code, SKU code, a unique order reference (
out_trade_no), the buyer-entered game fields (e.g. Player ID / Server), and your store’s webhook callback URL, so GamerHub can fulfil the order and notify you of the result. - Verify ID (optional) 鈥?if you enable the “Verify ID” button, the game fields the buyer types are sent to GamerHub to check the account exists before purchase.
- Account & order status 鈥?the plugin queries your GamerHub account balance/currency (connection test and before pricing) and polls an order’s status by reference. These send only your API key and the order reference (
out_trade_no); no customer data is sent.
The buyer-entered game fields (such as a Player ID) are personal data that leaves your site and is sent to GamerHub as a necessary part of delivering the ordered top-up.
- Terms of Service: https://portal.gamerhubstore.shop/terms
- Privacy Policy: https://portal.gamerhubstore.shop/privacy
No data is sent to any other third party.
Requirements
- A public HTTPS site (the status webhook is delivered to
/wp-json/gamerhub/v1/callback). - Server clock synced (NTP) 鈥?requests are signed with a 卤5-minute window.
- A GamerHub merchant account with sufficient balance.
Installation
- Install & activate the plugin (WooCommerce must be active first).
- Go to GamerHub 鈫?Settings and paste your API Key, API Secret and Webhook Secret from portal.gamerhubstore.shop, set a retail markup %, and Save. The Webhook Secret must be identical to the one set on your GamerHub merchant profile, or status callbacks are rejected.
- Whitelist this server’s IP on the API Key page in the portal (“Test connection” reports the exact IP to add).
- Click Sync catalog, then Import the products you want to sell.
- Place a small test order to confirm the full flow end-to-end.
FAQ
-
Does it need a GamerHub account?
-
Yes. This plugin is a client for the GamerHub merchant platform; you need a merchant account, API credentials, and enough wallet balance (orders draw the wholesale cost).
-
What does the customer have to fill in?
-
Only the game fields the product requires (e.g. Player ID, Server) 鈥?these come from GamerHub automatically. Vouchers require nothing; the buyer just pays and receives a code.
-
How are orders fulfilled?
-
When an order is paid, each unit is submitted to GamerHub over a signed request. The order stays in “processing” until GamerHub’s signed webhook confirms delivery, then it completes; failures are held for your review (never auto-refunded).
-
Is it compatible with High-Performance Order Storage (HPOS)?
-
Yes.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“GamerHub for WooCommerce” is open source software. The following people have contributed to this plugin.
Contributors
Translate “GamerHub for WooCommerce” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release: settings + connection test, batched catalog sync (variable products), player-ID fields, Verify ID, per-unit order placement, signed webhook receiver with replay protection, auto-sync, manual product linking.