Skip to content

Game Launch (Trial)

Get trial game URL, no player registration or real-money account required.

Endpoint

PropertyValue
PathPOST /papi/v1/game/launch-trial
AuthAgent Token (Bearer)
Content-Typeapplication/x-www-form-urlencoded

Request Parameters

ParameterTypeRequiredDescription
game_idstringYesGame ID (from Game List API, uses game_id field)
currencystringYesCurrency code (e.g. MYR, USD). Automatically converted to uppercase
platformstringNoPlatform type: WEB / MOBILE / DESKTOP, default WEB. Automatically converted to uppercase
languagestringNoLanguage code, default en-US

Request Example

bash
curl -X POST https://api.example.com/papi/v1/game/launch-trial \
  -H "Authorization: Bearer {agent_token}" \
  -d "game_id=xxxx-guid&currency=MYR&platform=WEB&language=en-US"

Response Fields

FieldTypeDescription
game_urlstringTrial game URL

Response Example

json
{
  "status": true,
  "code": 0,
  "data": {
    "game_url": "https://game.provider.com/trial?token=xxx&lang=en-US"
  },
  "msg": "success"
}

Error Codes

CodeMessageDescription
1001err.param.invalidRequired parameters missing (game_id, currency)
1002err.signature.invalidAgent Token verification failed
4001err.game.not_foundGame not found or offline
4005err.game.launch_failedGame launch failed
5002err.provider.call_failedGame provider API call failed

VCT Gaming Integration Platform