GoAPI Documentation

Welcome to the official GoAPI documentation. GoAPI is a premium slot and casino game aggregator designed for fast, secure, and stable integration into your website.

Authentication

All requests to the GoAPI require authentication using a unique agent_code and agent_token for each partner. These credentials must be sent in the JSON body of every request.

Rate & Pricing

GoAPI uses a 1 Balance (Nominal) system. The balance you see on the dashboard is the game nominal balance.

• Base Rate: 12% (Includes GoAPI service margin).
• How to Calculate: To deposit 1,000,000 balance to a player, simply send a deposit request of 1,000,000. Our system will automatically deduct 1,000,000 from your nominal balance (equivalent to Rp 120,000 on your payment side).

Provider List

Retrieve a list of all available game providers and their operational status.

Example Request

{
  "method": "provider_list",
  "agent_code": "YOUR_AGENT_CODE",
  "agent_token": "YOUR_AGENT_TOKEN"
}

Example Response (Success)

{
  "status": 1,
  "msg": "SUCCESS",
  "providers": [
    {
      "code": "PRAGMATIC",
      "name": "Pragmatic Play",
      "status": 1
    }
  ]
}

Game List

Retrieve a list of games based on a specific provider code.

Example Request

{
  "method": "game_list",
  "agent_code": "YOUR_AGENT_CODE",
  "agent_token": "YOUR_AGENT_TOKEN",
  "provider_code": "PRAGMATIC"
}

Game Launch

Open a game session for a player and return a game URL ready to be loaded (iframe).

Example Request

{
  "method": "game_launch",
  "agent_code": "YOUR_AGENT_CODE",
  "agent_token": "YOUR_AGENT_TOKEN",
  "user_code": "PLAYER_123",
  "provider_code": "PRAGMATIC",
  "game_code": "vs20doghouse",
  "lang": "id",
  "lobby_url": "https://your-site.com/lobby"
}

Transfer (Deposit / Withdraw)

Move balance between GoAPI Agent wallet and player wallet in the game.

Example Request (Deposit)

{
  "method": "user_deposit",
  "agent_code": "YOUR_AGENT_CODE",
  "agent_token": "YOUR_AGENT_TOKEN",
  "user_code": "PLAYER_123",
  "amount": 100000.00,
  "agent_sign": "UNIQUE_UUID_STRING"
}

* agent_sign is optional but highly recommended (use UUID) to prevent duplicate transactions in case of network timeout.

Game Logs

Retrieve game transaction history (bet/win) within a specific time range.

Example Request

{
  "method": "get_game_log",
  "agent_code": "YOUR_AGENT_CODE",
  "agent_token": "YOUR_AGENT_TOKEN",
  "user_code": "PLAYER_123",
  "game_type": "slot",
  "start": "2023-10-01 00:00:00",
  "end": "2023-10-01 23:59:59",
  "page": 0,
  "perPage": 100
}

In-Game History

Get a direct URL to the provider's game history page (Currently only supported for Pragmatic Play Slot).

Example Request

{
  "method": "get_game_history",
  "agent_code": "YOUR_AGENT_CODE",
  "agent_token": "YOUR_AGENT_TOKEN",
  "user_code": "PLAYER_123",
  "provider_code": "PRAGMATIC",
  "game_code": "vs20doghouse"
}

PHP Integration Example

Here is a complete example of GoAPI integration using Native PHP for your website.

<?php
define('GOAPI_URL', 'https://api.gotopup.shop');
define('AGENT_CODE', 'YOUR_AGENT_CODE');
define('AGENT_TOKEN', 'YOUR_AGENT_TOKEN');

function callGoAPI($method, $params = []) {
    $url = GOAPI_URL . '/' . $method;
    $payload = array_merge([
        'agent_code' => AGENT_CODE,
        'agent_token' => AGENT_TOKEN
    ], $params);
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'Content-Type: application/json'
    ]);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_TIMEOUT, 30);
    $response = curl_exec($ch);
    curl_close($ch);
    return json_decode($response, true);
}
?>

<?php
require_once 'config.php';
$result = callGoAPI('transfer', [
    'method' => 'user_deposit',
    'user_code' => 'player123',
    'amount' => 100000,
    'agent_sign' => uniqid('dep_', true)
]);
if ($result['status'] == 1) {
    echo "Success! Balance: " . $result['user_balance'];
}
?>

<?php
require_once 'config.php';
$result = callGoAPI('launch', [
    'method' => 'game_launch',
    'user_code' => 'player123',
    'provider_code' => 'PRAGMATIC',
    'game_code' => 'vs20doghouse',
    'lang' => 'id',
    'lobby_url' => 'https://yoursite.com/lobby'
]);
if ($result['status'] == 1) {
    header('Location: ' . $result['launch_url');
    exit;
}
?>