Vote integration

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-intents
  • GET /api/v1/vote-intents/{intent_id}
  • GET /api/v1/servers/{public_id}/votes/unclaimed
  • POST /api/v1/servers/{public_id}/votes/claim
  • GET /api/v1/servers/{public_id}/stats
  • GET /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.

Download the PHP example

Download the PHP example