Incentive Postback

Automatically reward players who vote for your server with a simple callback system.

How It Works

When a player votes for your server on MMO Top Forge, we immediately send a GET request to your Postback URL with query parameters containing the vote details. Your server receives the notification and can automatically reward the player — no polling or API calls needed.

Setup

Edit your server listing and enter your Postback URL (e.g. http://yoursite.com/callback.php).
A unique secret is generated for your server — use it to validate that requests come from MMO Top Forge.
When a player votes, we call your URL with the vote details.
Your script verifies the secret and grants the reward.

Query Parameters

Your Postback URL receives these query parameters on every vote callback.

secret  — Your API secret — validate that the request came from MMO Top Forge
voted   — 1 = successful vote, 0 = failed or duplicate
userip  — The voter's IP address
userid  — The voter's login name entered on the vote form

Example Request

This is what the GET request to your server looks like when a player votes.

GET http://yoursite.com/callback.php?secret=YOUR_SECRET&voted=1&userip=89.149.92.54&userid=player123

Vote Widget with Incentive

Set a Postback URL when adding or editing your server listing. When a player votes, we send a GET request to your URL with the following query parameters: • secret — your API secret (use it to validate the request came from MMO Top Forge). Value is TEST on our test page, or your real secret in production. • voted — 1 for a successful vote, 0 for a failed/duplicate one. • userip — the voter's IP address. • userid — the voter's login name as entered on the vote form. Example request: GET http://yoursite.com/callback.php?secret=YOUR_SECRET&voted=1&userip=89.149.92.54&userid=player123 Your script receives the request and can grant the reward automatically — no polling required.

Incentive Postback — Setup

Go to Add Server or edit your existing listing.
Fill in the Postback URL field with your callback endpoint:
http://yoursite.com/callback.php
On your server, create a script that reads the query parameters (secret, voted, userip, userid) and rewards the player.
Validate the secret parameter matches your API secret to ensure the request is legitimate.
The request is sent once per vote, immediately after the player completes the captcha.