PHL API Specification
Document Version: 1.11 · Date: 2025-12-23
This site documents the PHL integration APIs for merchants (operators). It covers two integration models, the common request/response envelope with MD5 signing, and the full endpoint reference.
Integration Models
| Model | Description | Where to start |
|---|---|---|
| Non-Seamless (Transfer Wallet) | Player funds are transferred between the operator wallet and the PHL wallet. The operator polls PHL for transaction records. | Transfer Wallet Integration |
| Seamless Wallet | The player's balance stays in the operator wallet. PHL calls back into operator-hosted endpoints for balance, bet, cancel, and settlement. | Seamless Wallet Integration |
Merchant Information
Merchant needs to provide whitelist IP addresses during registration.
| Name | Description | Sample Value |
|---|---|---|
| Merchant Code | Merchant account is a unique identifier in the system and starts with "PNLM" followed by 6 digits | PNLM000001 |
| API Secret Key | The key used for signing and verifying signatures, provided by our system | DMJ3L5ZEUAFHOLMH5PRWIHFEXVTGGE4Y |
| ReturnURL | Player logout return URL | https://platformhome.com |
Environment
| Item | Value |
|---|---|
| Base URL | https://prod.phl8268.com/panel/api/integration |
| API Secret Key | Provided during merchant registration; used to invoke PHL endpoints and sign every request/response. |
info
Every API in this specification uses the same envelope: the business payload is JSON, Base64-encoded into the data field, and signed with MD5. See Common Request Format and Common Response Format before calling any endpoint.
API Index
| API | Name | Category |
|---|---|---|
| API_001 | Player Login | General |
| API_002 | Player Logout | General |
| API_003 | Get Player Balance | Transfer Wallet |
| API_004 | Get Transfer Balance Record | Transfer Wallet |
| API_006 | Transfer Player Balance | Transfer Wallet |
| API_007 | Get Transaction Records | General |
| API_008 | Remove Transaction Records | General |
| API_009 | Get Settled Transaction Records | General |
| API_010 | Remove Settled Transaction Records | General |
| API_011 | Get User Transaction Records | General |
| API_012 | Get Ticket Record | General |
| — | Get Player Balance | Seamless (implemented by operator) |
| — | Place Bet | Seamless (implemented by operator) |
| — | Cancel Bet | Seamless (implemented by operator) |
| — | Settle | Seamless (implemented by operator) |