Player Register

Register a player account on the Hub platform.

Endpoint

Property	Value
Path	POST /papi/v1/player/register
Auth	Agent Token (Bearer)
Content-Type	application/x-www-form-urlencoded

Request Parameters

Parameter	Type	Required	Description
member_id	string	Yes	Player unique identifier (Agent-side ID). Only letters and digits allowed. Automatically converted to lowercase
currency	string	No	Currency code (e.g. MYR, USD). If provided, a wallet with balance=0 will be auto-created. Automatically converted to uppercase
nickname	string	No	Player nickname
language	string	No	Language code, e.g. zh-CN, en-US, default en-US

Request Example

curl -X POST https://api.example.com/en/papi/v1/player/register \
  -H "Authorization: Bearer {agent_token}" \
  -d "member_id=player001&currency=MYR&nickname=Player%20One&language=en-US"

Response Fields

Field	Type	Description
player_id	string	Player unique ID (platform GUID)
member_id	string	Original member_id (lowercased)
status	string	Account status: active
currency	string	Currency code (only returned when currency is provided)
balance	decimal	Initial balance: 0 (only returned when currency is provided)

Response Example

Without currency

{
  "status": true,
  "code": 0,
  "data": {
    "player_id": "45eee69c-5f81-4ed6-9da3-435eaa51f1a1",
    "member_id": "player001",
    "status": "active"
  },
  "msg": "success"
}

With currency

{
  "status": true,
  "code": 0,
  "data": {
    "player_id": "45eee69c-5f81-4ed6-9da3-435eaa51f1a1",
    "member_id": "player001",
    "status": "active",
    "currency": "MYR",
    "balance": 0
  },
  "msg": "success"
}

Error Codes

Code	Message	Description
1001	err.param.invalid	member_id is missing
1002	err.signature.invalid	Agent Token verification failed
2002	err.player.duplicate	Player already exists (duplicate member_id under same agent)
2005	err.player.register_failed	Registration process error
2006	err.player.member_id_invalid	Invalid member_id format (contains illegal characters)