Visão geral
Esta API permite integrar seus jogos ao sistema de parceiros com autenticação por chaves, abertura de jogo via launch_url e callbacks de balanceamento.
Recomendado para integrações B2B com controle de saldo e auditoria de apostas.
Base e autenticação
Base da API
https://api.phrjpay.site/api/v1
Use sempre HTTPS e Content-Type application/json.
Credenciais
Campos obrigatórios: agentToken e secretKey
As chaves são geradas no createagent.
Callback URL
Defina callbackurl com barra final
Ex: https://seusite.com/ para montar /gold_api/...
Fluxo de integração
1 Crie o agente com createagent e guarde agentToken e secretKey.
2 Configure callbackurl para receber /gold_api/user_balance e /gold_api/game_callback.
3 Chame game_launch e abra o launch_url retornado.
4 Receba callbacks de jogo para auditoria e controle de saldo.
Endpoint: createagent
POST
/api/v1/createagent
Obrigatórios agentCode, agentToken, secretKey
Opcionais saldo, probganho, probbonus, probganhortp, probganhoinfluencer, probbonusinfluencer, probganhoaposta, probganhosaldo, callbackurl
{
"agentCode": "parceiro01",
"agentToken": "TOKEN_PARCEIRO",
"secretKey": "SECRET_PARCEIRO",
"saldo": 1000,
"callbackurl": "https://parceiro.com/"
}
Resposta: {"message":"Agente criado com sucesso.","agentId":123}
Endpoint: getagent
POST
/api/v1/getagent
{
"agentToken": "TOKEN_PARCEIRO",
"secretKey": "SECRET_PARCEIRO"
}
Retorna os dados do agente com parâmetros e callbackurl.
Endpoint: attagent
POST
/api/v1/attagent
Obrigatórios agentToken, secretKey
Opcionais probganho, probbonus, probganhortp, probganhoinfluencer, probbonusinfluencer, probganhoaposta, probganhosaldo
{
"agentToken": "TOKEN_PARCEIRO",
"secretKey": "SECRET_PARCEIRO",
"probganho": "0",
"probbonus": "0"
}
Resposta: {"status":"success","message":"Probabiliades alteradas com sucesso."}
Endpoint: game_launch
POST
/api/v1/game_launch
Obrigatórios agentToken, secretKey, user_code, user_balance, provider_code, game_code
Opcionais game_type, is_influencer, rtpagent, rtpinfluencer
{
"agentToken": "TOKEN_PARCEIRO",
"secretKey": "SECRET_PARCEIRO",
"user_code": "user_123",
"user_balance": 1000,
"provider_code": "PGSOFT",
"game_code": "fortune-tiger",
"game_type": "slot",
"is_influencer": false
}
Resposta de sucesso inclui launch_url, user_balance, user_created e currency.
Callback: user_balance
Sua aplicação deve expor:
POST
{callbackurl}gold_api/user_balance
{
"user_code": "user_123"
}
Respostas esperadas:
OK {"msg":"OK"}
Erro {"msg":"INVALID_USER"} ou {"msg":"INSUFFICIENT_USER_FUNDS"}
Callback: game_callback
POST
{callbackurl}gold_api/game_callback
{
"agent_code": "parceiro01",
"agent_secret": "SECRET_PARCEIRO",
"user_code": "user_123",
"user_balance": 980,
"user_total_credit": 120,
"user_total_debit": 140,
"game_type": "slot",
"slot": {
"provider_code": "PGSOFT",
"game_code": "fortune-tiger",
"round_id": "123456",
"type": "BASE",
"bet": 20,
"win": 0,
"txn_id": "uuid",
"txn_type": "debit_credit",
"is_buy": false,
"is_call": false,
"user_before_balance": 1000,
"user_after_balance": 980,
"agent_before_balance": 100,
"agent_after_balance": 100,
"created_at": "2026-01-01T12:00:00.000Z"
}
}
Retorne HTTP 200 para confirmar o recebimento.
Jogos disponíveis (game_code)
Use provider_code PGSOFT para os jogos abaixo.
fortune-tiger
fortune-ox
fortune-dragon
fortune-rabbit
fortune-mouse
bikini-paradise
jungle-delight
ganesha-gold
double-fortune
dragon-tiger-luck
ninja-raccoon
lucky-clover
ultimate-striker
prosper-ftree
chicky-run
butterfly-blossom
cash-mania
treasures-aztec
gdn-ice-fire
piggy-gold
wild-bandito
zombie-outbreak
majestic-ts
thai-river
rise-apollo
wild-bounty-sd
three-cz-ds
fortune-snake
Para provider_code PRAGMATIC, use game_code conforme catálogo do provedor.
Erros comuns
Agent Token não cadastrado Verifique agentToken
Secret Key não cadastrado Verifique secretKey
User Balance deve ser um numero Envie user_balance numérico
Esse game não existe Use game_code válido