# <font >Withdraw</font>
## 4.4.1    Description

>This function is to transfer player balance from Game Provider's wallet to Operator's wallet.son

> Request method:（ Host-> BeSoft）:post 

> Encoding method：application/x-www-form-urlencoded

> Besoft The response data format is: application/json

##   Method URL

```
{besoftapi}/api/game/withdraw
```


##    Request Parameters

 | Name | Type | Required |Description|
 |:--------:|:-----:|:--------:|:--------:|
 | cert | string | Y |security code|
 | user | string  | Y |User ID|
 | extension1 | string | Y |Agent Id|
 | score | string | N |1.The updated score: If the score is less than zero, it indicates that the agent has given points to the player;    ，    2.if the score is greater than zero, it indicates that the agent has deducted points from the player.|
  | traceid | String | N | Unique identification code for each transaction |


 ## Example
- URL:
    - http://127.0.0.1:8000/api/game/withdraw
- HTTP Method
    -   POST
- Form Data
    > Content-Type: application/x-www-form-urlencoded
    ``` 
    cert:v8VMKKzlPpD0te4rX99Hgefs3PQrBFWJKiuUqg6Y
    user:test1
    extension1:adminweb
    score: -1000
    traceid: bipdk81q8lqzg1jjvq6
    ```
	
	
##    Return Result

 | Name | Type | Description |
 |:--------:|:-----:|:--------:|
 |status| int32 |status code |
 | useraddscore| double | The player changed score |
 | beforeuserscore | double | Before the transfer, the player's score|
 |afteruserscore | double | After the transfer, the player's score|
 | traceid | String |  Unique identification code for each transaction |

 ##  Success Result

```
{
    "afteruserscore": 1000,
    "beforeuserscore": 0,
    "status": 1,
    "useraddscore": 1000,
    "traceid": "123124233"
}
```

 ##    Failed Result

```
{
"status": 1001
}
```


