MooGold API Gateway Reference
Supports direct MooGold proxy requests and RESTful OpenAPI routes with high-speed proxy signing.
Authentication & Architecture
JZGateway allows you to submit requests using your Gateway API Key. The gateway automatically generates upstream HMAC-SHA256 signatures, manages timestamps, and signs requests directly to MooGold:
POST /api/v1/user/balance
POST /api/v1/order/create_order
POST /api/v1/order/order_detail
POST /api/v1/product/list_product
GET /v1/balance
POST /v1/order/create
GET /v1/order/:id
GET /v1/products
Accepted Auth Headers
Orders
Manage top-up purchases, inspect orders, and query history.
Submits a new order to MooGold. The endpoint acts as a proxy, signing the payload with your credentials and storing a transaction reference in the gateway database.
Request Body Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| category | integer | Yes | Use 1 for Direct Top Up, 2 for eVouchers. |
| product-id | integer | Yes | MooGold Variation ID (e.g. 215570). |
| quantity | integer | Yes | Number of items (e.g., 1). |
| User ID | string | Conditional | The player ID required by game or service. |
| Server | string | Conditional | The game server ID (if required). |
| partner_order_id | string | No | Unique reference ID from your system. Generated automatically if omitted. |
Retrieves details of an order using the MooGold order ID.
Retrieves details of an order using your partner order ID.
Fetches past order history for a date range (max 30 days).
Products & Packages
Query available products, variations, prices, validation fields, and server lists.
Returns list of products for a category.
Category IDs Reference:
50 = Direct Top-Up, 51 = Gift Cards, 538 = Google Play, 766 = Garena Shells, 993 = Steam.
Get information for a single product, including dynamic input fields and variation IDs.
Retrieves the server list for a specific product ID (e.g. for games like Free Fire).
Validates target player account details before submitting order.
Queries the wallet balance of the MooGold account configured for this client key.
Error Codes
The gateway forwards MooGold error codes directly to your application:
| Code | Meaning |
|---|---|
| 111 | Insufficient balance in your MooGold account |
| 113 | Product ID missing |
| 114 | Product out of stock |
| 117 | Quantity exceeds maximum (10) |
| 401 | Invalid or missing platform API key |
| 403 | MooGold account not authorized for this resource |
| 419 | Missing required arguments |
Callbacks & Automated Fulfillment
When you create a top-up or eVoucher order, MooGold processes it asynchronously. When completed, refunded, or fulfilled with voucher codes, MooGold sends a real-time HTTP POST callback.
How to Register your Callback URL in MooGold:
- Log in to your MooGold Account Portal (moogold.com/my-account).
- Navigate to API Settings → Callback URL / Webhook URL.
- Copy your personalized callback URL from your Dashboard Settings or format it with your User ID:https://jzpay.shop/api/callback/{your_user_id}
- Paste and save the URL in MooGold.