Settlement Callback
Provider notifies VCT platform to credit player with winnings (settlement).
Note
This API is called by the game provider for settlement payouts in Seamless wallet mode.
Endpoint
| Property | Value |
|---|---|
| Path | POST /api/v1/callback/settle |
| 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 | Payout amount (positive) |
transaction_id | string | Yes | Unique transaction ID |
round_id | string | No | Game round ID |
game_code | string | No | Game code |
game_type | string | No | Game type |
bet_amount | decimal | No | Original bet amount |
valid_bet_amount | decimal | No | Valid bet amount |
prize_amount | decimal | No | Prize amount |
win_loss | decimal | No | Win/loss amount |
orders | array | No | Order details list |
sign | string | Yes | Signature |
timestamp | long | Yes | Timestamp |
Response Fields
| Field | Type | Description |
|---|---|---|
balance | decimal | Balance after settlement |
transaction_id | string | Transaction ID |
status | string | Processing status |
Provider Source Mapping
| Provider | Callback Path | Request Format |
|---|---|---|
| BG | open.operator.calc.transfer | JSON-RPC 2.0, orders with orderStatus/amount |
| GSC | seamless/deposit | JSON, transactions with action=SETTLED |
| SA | PlayerWin / PlayerLost | Encrypted body, separate callbacks for win/loss |
| WM | webhook (cmd=PointInout, code=1) | form-data, money = payout amount |