Fund Transfer
Transfer funds into or out of a player's wallet on the game provider.
Endpoint
| Property | Value |
|---|---|
| Path | POST /papi/v1/player/transfer |
| Auth | Agent Token (Bearer) |
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
provider | string | Yes | Provider identifier |
operator_code | string | Yes | Operator code |
currency | string | Yes | Currency code |
username | string | Yes | Player username |
amount | decimal | Yes | Transfer amount (positive = deposit, negative = withdraw) |
transfer_id | string | Yes | Unique transfer ID (idempotency control) |
transfer_type | string | Yes | Transfer type: deposit / withdraw |
Request Example
json
{
"provider": "BG",
"operator_code": "OP001",
"currency": "CNY",
"username": "player_001",
"amount": 500.00,
"transfer_id": "TXN20260326001",
"transfer_type": "deposit"
}Response Fields
| Field | Type | Description |
|---|---|---|
transfer_id | string | Transfer ID |
username | string | Player username |
amount | decimal | Actual transfer amount |
balance_before | decimal | Balance before transfer |
balance_after | decimal | Balance after transfer |
status | string | Transfer status: success / failed / pending |
Response Example
json
{
"code": 0,
"message": "success",
"data": {
"transfer_id": "TXN20260326001",
"username": "player_001",
"amount": 500.00,
"balance_before": 1000.00,
"balance_after": 1500.00,
"status": "success"
},
"timestamp": 1711411200000,
"request_id": "req_ghi789"
}Seamless Wallet Mode
SA and WM use Seamless wallet mode where fund changes are handled automatically via provider callbacks. Manual transfer calls are generally not needed. BG and GSC support active transfer mode.
Provider Mapping
| Provider | API | Notes |
|---|---|---|
| BG | open.operator.user.transfer | JSON-RPC 2.0, positive = deposit / negative = withdraw |
| GSC | seamless/withdraw + seamless/deposit | Separate APIs, withdraw = deduction, deposit = credit |
| SA | Seamless wallet mode | Handled via callbacks, no manual transfer needed |
| WM | Seamless wallet mode | Handled via Webhook pointInout |