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.
- 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 |