Integração FiverGames API

Base da API

As requisições devem ser enviadas via POST para o endpoint da integração.

Autenticação

Todas as requisições precisam enviar as credenciais do agente.

Campo	Tipo	Obrigatório	Descrição
agent_code	string	Sim	Código do agente cadastrado.
agent_token	string	Sim	Token secreto do agente.
method	string	Sim	Método que será executado pela API.

{
  "agent_code": "AGENT001",
  "agent_token": "TOKEN_SECRETO",
  "method": "provider_list"
}

Provider List

Retorna a lista de provedores disponíveis.

method: provider_list

{
  "agent_code": "AGENT001",
  "agent_token": "TOKEN_SECRETO",
  "method": "provider_list"
}

{
  "status": 1,
  "msg": "SUCCESS",
  "providers": [
    {
      "code": "PGSOFT",
      "name": "PG Soft",
      "status": 1
    }
  ]
}

Game List

Retorna os jogos ativos de um provedor.

method: game_list provider_code: PGSOFT

Campo	Descrição
provider_code	Código do provedor. Atualmente aceito: PGSOFT.

{
  "agent_code": "AGENT001",
  "agent_token": "TOKEN_SECRETO",
  "method": "game_list",
  "provider_code": "PGSOFT"
}

{
  "status": 1,
  "msg": "SUCCESS",
  "games": [
    {
      "game_code": "126",
      "game_name": "Fortune Tiger",
      "banner": "https://...",
      "status": 1
    }
  ]
}

Game Launch

Cria uma sessão de jogo, injeta saldo no usuário e retorna a URL de lançamento.

method: game_launch provider_code: PGSOFT provider_code: PRAGMATIC

Campo	Tipo	Obrigatório	Descrição
user_code	string	Sim	Código do usuário dentro do agente.
game_code	string	Sim	Código do jogo.
provider_code	string	Sim	Provedor do jogo. Aceita PGSOFT ou PRAGMATIC.
balance	decimal	Sim	Saldo que será transferido do agente para o usuário no lançamento.

{
  "agent_code": "AGENT001",
  "agent_token": "TOKEN_SECRETO",
  "method": "game_launch",
  "provider_code": "PGSOFT",
  "user_code": "user123",
  "game_code": "126",
  "balance": 10.00
}

{
  "status": 1,
  "msg": "SUCCESS",
  "launch_url": "https://api.fivergames.com/pgsoft/iframe/SESSION_ID"
}

Money Info

Consulta saldo do agente, de um usuário específico ou de todos os usuários.

method: money_info

{
  "agent_code": "AGENT001",
  "agent_token": "TOKEN_SECRETO",
  "method": "money_info"
}

{
  "status": 1,
  "msg": "SUCCESS",
  "agent": {
    "agent_code": "AGENT001",
    "balance": 1000.00
  }
}

Consulta de usuário específico:

{
  "agent_code": "AGENT001",
  "agent_token": "TOKEN_SECRETO",
  "method": "money_info",
  "user_code": "user123"
}

Consulta de todos os usuários:

{
  "agent_code": "AGENT001",
  "agent_token": "TOKEN_SECRETO",
  "method": "money_info",
  "all_users": true
}

User Create

Cria um usuário vinculado ao agente e transfere saldo inicial do agente para o usuário.

method: user_create

Campo	Tipo	Obrigatório	Descrição
user_code	string	Sim	Código único do usuário.
balance	decimal	Sim	Saldo inicial. Deve ser maior que zero.

{
  "agent_code": "AGENT001",
  "agent_token": "TOKEN_SECRETO",
  "method": "user_create",
  "user_code": "user123",
  "balance": 20.00
}

{
  "status": 1,
  "msg": "SUCCESS",
  "user_code": "user123",
  "user_balance": 20.00,
  "agent_balance": 980.00
}

Deposit / Withdraw / Reset / Game Log

Estes métodos estão disponíveis, mas alguns retornam mensagens informativas conforme a regra atual do controller.

Método	Retorno atual
user_deposit	Deposit not supported, use balance injection via gameLaunch
user_withdraw	Withdraw not supported, use webhook on exit
user_withdraw_reset	SUCCESS
get_game_log	SUCCESS com data: []

{
  "agent_code": "AGENT001",
  "agent_token": "TOKEN_SECRETO",
  "method": "user_withdraw_reset",
  "user_code": "user123"
}

Códigos de erro

Principais mensagens retornadas pela API.

Mensagem	Significado
INVALID_AGENT	Agent code ou token inválido.
INVALID_METHOD	Método enviado não existe.
INVALID_PROVIDER	Provedor inválido.
INVALID_GAME	Jogo não encontrado.
INVALID_USER	Usuário não encontrado para o agente.
INSUFFICIENT_AGENT_FUNDS	Agente não possui saldo suficiente.
DUPLICATED_USER	Usuário já existe.
LAUNCH_FAILED	Falha ao gerar URL do jogo.
INTERNAL_ERROR	Erro interno no servidor.