> For the complete documentation index, see [llms.txt](https://scorpioplay.gitbook.io/scorpio-play-casino-api-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://scorpioplay.gitbook.io/scorpio-play-casino-api-doc/api-reference/openapi/v1-player-wallet-deposit.md).

# /v1/player/wallet/deposit

Balance Transfer Only

## Deposit funds into a player's wallet

<mark style="color:$success;">`POST`</mark> `/v1/player/wallet/deposit`

Credits the specified amount to a player's wallet. This endpoint is typically triggered by the operator when a player purchases chips or receives promotional credit. Only positive amounts are allowed. Not needed in Seamless integration.

**Headers**

| Name          | Value                |
| ------------- | -------------------- |
| Authorization | `Bearer <API_TOKEN>` |
| Content-Type  | `application/json`   |
| Accept        | `application/json`   |

**Request Body**

```json
{
  "playerExternalId": "playerId_onOperatorSide",
  "currency": "USD",
  "amount": 1000.5
}
```

<table><thead><tr><th width="175">Key</th><th width="124">Data Type</th><th width="333">Description</th><th>Mandatory</th></tr></thead><tbody><tr><td>playerExternalId</td><td>string</td><td>Unique player identifier from the operator’s system</td><td>Required</td></tr><tr><td>currency</td><td>string</td><td>Currency code for the wallet transaction (e.g., USD)</td><td>Required</td></tr><tr><td>amount</td><td>number</td><td>Amount to deposit or withdraw from the player’s wallet</td><td>Required</td></tr></tbody></table>

**Response**

```json
{
  "success": true,
  "message": "OK",
  "data": {
    "currency": "USD",
    "balance": 990.99,
    "depositAmount": 100.59
  }
}
```

<table><thead><tr><th width="195">Key</th><th width="115">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>success</td><td>boolean</td><td>Indicates whether the request was processed successfully</td></tr><tr><td>message</td><td>string</td><td>Result message of the request</td></tr><tr><td>data.currency</td><td>string</td><td>Currency code of the player’s wallet</td></tr><tr><td>data.balance</td><td>number</td><td>Player’s wallet balance after the transaction</td></tr><tr><td>data.depositAmount</td><td>number</td><td>Amount that was successfully deposited into the wallet</td></tr></tbody></table>