Balance Query Callback
Provider queries the player's balance on the VCT platform.
Note
This API is called by the game provider to the VCT platform for balance queries in Seamless wallet mode. Agents need to implement this interface for provider callbacks.
Endpoint
| Property | Value |
|---|---|
| Path | POST /api/v1/callback/balance |
| Caller | Game Provider → VCT Platform |
Request Parameters (from Provider)
| Parameter | Type | Required | Description |
|---|---|---|---|
provider | string | Yes | Provider identifier (auto-detected from request source) |
username | string | Yes | Player username |
currency | string | No | Currency code |
sign | string | Yes | Request signature |
timestamp | long | Yes | Request timestamp |
Response Fields
| Field | Type | Description |
|---|---|---|
balance | decimal | Player's current balance |
currency | string | Currency code |
username | string | Player username |
Provider Source Mapping
| Provider | Callback Path | Request Format |
|---|---|---|
| BG | open.operator.user.balance | JSON-RPC 2.0 (sn/sign/random) |
| GSC | seamless/balance | JSON (operator_code/sign/request_time) |
| SA | GetUserBalance | Encrypted URL-encoded body |
| WM | webhook (cmd=CallBalance) | form-data (cmd/signature/user) |