Bet Deduction Callback
Provider notifies VCT platform to deduct player balance (bet placement).
Note
This API is called by the game provider for bet deductions in Seamless wallet mode.
Endpoint
| Property | Value |
|---|---|
| Path | POST /api/v1/callback/bet |
| Caller | Game Provider → VCT Platform |
Request Parameters (from Provider)
| Parameter | Type | Required | Description |
|---|---|---|---|
provider | string | Yes | Provider identifier |
username | string | Yes | Player username |
amount | decimal | Yes | Deduction amount (positive) |
transaction_id | string | Yes | Unique transaction ID (idempotency) |
round_id | string | No | Game round ID |
game_code | string | No | Game code |
game_type | string | No | Game type |
bet_detail | object | No | Bet details |
sign | string | Yes | Signature |
timestamp | long | Yes | Timestamp |
Response Fields
| Field | Type | Description |
|---|---|---|
balance | decimal | Balance after deduction |
transaction_id | string | Transaction ID |
status | string | Status: success / insufficient_balance / player_not_found |
Provider Source Mapping
| Provider | Callback Path | Request Format |
|---|---|---|
| BG | open.operator.order.transfer | JSON-RPC 2.0, contains orders array |
| GSC | seamless/withdraw | JSON, batch_requests with transactions |
| SA | PlaceBet | Encrypted body |
| WM | webhook (cmd=PointInout, code=2) | form-data |