Public Description

1. About Merchants

  • All APIs are provided by the POP platform for carrier access and calling.
  • After approval of account opening requirements, we will provide a carrier backend account. Carriers can view the AppID (Merchant Number) and AppSecret (Merchant Code) through the backend.
  • POP server time zone: UTC+0, pay attention to time zone calculation when accessing data statistics.
  • APIs provided by POP: code returns 0 indicates success.

2. Common Parameters (Required for All API Calls by Platform to Merchant)

  • API URL, AppID, and AppSecret in the document will be provided by us after carrier application.
  • All interface requests need to add 2 Headers: AppID and AppSecret.
Parameter Location Required Type Description
AppID header Yes string Unique carrier identifier
AppSecret header Yes string Carrier AppSecret

3. Interface Protocol

  • Request data Header sets Content-Type: application/json.
  • All interfaces use POST.
  • Return JSON in fixed {“code”:int, error: string, data: object} format, code not equal to 0 indicates an error, data field should not be used in this case, code:0 indicates success, when code is not 0, error represents the error description.
  • Datetime uses RFC3339 format.
  • Can use [mockapi] for testing
    Note: Only focus on interfaces under /api/v1/

4. Request

  • Content-Type when requesting platform: “application/json;charset=UTF-8”

5. Call Return

  • When the platform returns http code 200, the HTTP API access is normal and the return result can be parsed normally. Other http errors indicate a link exception.
  • When the call returns normally, the returned Content-Type is: “application/json;charset=UTF-8”.
复制{
  "code": 0,
  "error": "",
  "data": {
    "glist": [
      {
        "gameid": "9",
        "name": "mine",
        "platform": "1"
       }
      ]
     }
   }

Return Parameter Description

Parameter Type Description
code integer Error code, 0 indicates normal call, interface return data will be placed in the data parameter
error string Error message
data object Returned data

6. Error Code

Code Description
0 Success
1001 Operator is disabled
1002 Invalid merchant ID
1003 Route provider is disabled
1004 Game not found
1005 The game is under maintenance
1006 The game is closed
1007 The game is hidden
1008 User ID is empty
1009 Invalid wallet type
1011 Invalid merchant code
1012 Your country or region is restricted
1013 Route provider is not allowed to call the API
1014 IP is not allowed to access
1015 Incorrect RTP assignment
1016 Incorrect transfer amount
1017 Order already exists
1018 Order does not exist
1019 Request too frequent
2001 Player does not exist
2002 Player is disabled