Metin2-Help records and validates the vote. Your server website identifies the player, grants the reward in its own system and confirms processing. We do not receive game credentials and we do not change coins or items.
Guide for Apache, Nginx, Laravel, WordPress and Cloudflare
Submission, approved publication, voting, the standard widget and the basic API are free. There is no subscription.
API
POST /api/v1/servers/{public_id}/vote-intentsGET /api/v1/vote-intents/{intent_id}GET /api/v1/servers/{public_id}/votes/unclaimedPOST /api/v1/servers/{public_id}/votes/claimGET /api/v1/servers/{public_id}/statsGET /api/v1/servers/{public_id}/integration
What do I install on my website?
Plain vote link
It can be placed in an HTML button. It does not contain a player id and it does not grant a reward by itself.
Reward vote
already_claimed only means Metin2-Help recorded the confirmation. It does not prove the local reward was granted. Your unique Vote ID journal is the proof. If the reward and the journal share a database, keep them in one transaction. If that is not possible, resume from the journal; this is not an exactly-once delivery into the game.
Vote4Coins-style systems
Different terms
What can be established about Vote4Coins
What do I copy, and where?
The Vote4Coins link and the identifier
The link ends with ID. A website that replaces ID opens the page for that account, but it does not create a vote intent. A website that leaves ID unchanged does not attach a player. The token in the link is not the API key. A confirmed reward stays with the advanced connection: an intent created by the website, a confirmed vote, and claim.
Simple vote: the player opens the page and votes, with no player ID attached.
Reward vote: your website creates the intent, and the reward is granted only on your side after confirmation.
POST /vote-intents
{
"player_ref": "Hero.1",
"idempotency_key": "player-hero-1-try"
}
{
"intent_id": "0123456789abcdef01234567",
"vote_url": "https://metin2-help.com/servere/{slug}/vot/{token}",
"expires_at": "2026-11-14 02:00:00",
"status": "pending"
}
POST /votes/claim
{ "vote_ids": [120] }
{ "data": [{ "vote_id": 120, "result": "claimed" }] }
401 means the key is missing or wrong. 403 means another server, an unapproved server or unverified ownership. 404 is a missing intent. 422 is an invalid identifier. 429 is the rate limit.
The webhook is optional and stays off until you enable it. The signature is HMAC-SHA256 over the timestamp, nonce and body. Polling remains the recovery method. We do not send to internal addresses.
Paid promotion is not active and does not change the order of votes.