Pingback Documentation

1. Share your voting link

Replace the placeholder with the player's in-game name. Only A–Z and 0–9 are supported.

https://arcavote.com/game/your-game?name=PLAYERNAME

2. Add your callback URL

Enter your callback URL under Edit Game in the dashboard. Your secret callback key is displayed there.

3. Verify incoming requests

After each successful vote, we send a form-encoded POST with game_id, name, ip, time and signature. The signature is HMAC-SHA256 of game_id|name|ip|time using your secret. Respond with HTTP 2xx.

<?php
// callback.php auf deinem Server
$secret = 'DEIN_CALLBACK_SECRET';
$data = $_POST;
$check = hash_hmac('sha256', implode('|', [$data['game_id'] ?? '', $data['name'] ?? '', $data['ip'] ?? '', $data['time'] ?? '']), $secret);
if (!hash_equals($check, $data['signature'] ?? '') || abs(time() - (int)$data['time']) > 300) {
    http_response_code(403);
    exit;
}
// Belohnung vergeben, z. B.:
// $pdo->prepare('UPDATE players SET dark_matter = dark_matter + 250 WHERE name = ?')->execute([$data['name']]);
http_response_code(200);

Voting button

Embed the button on your website (small: 88×31, large: &size=big).

<a href="https://arcavote.com/game/your-game"><img src="https://arcavote.com/button.php?id=YOUR_ID" alt="Vote for us"></a>