# 更新监听钱包

{% hint style="info" %}
说明

更新[监听模式](https://apidoc.tokenpay.me/chinese/shuo-ming/zhi-fu-fang-shi)下的钱包
{% endhint %}

### 接口地址 <a href="#jie-kou-di-zhi" id="jie-kou-di-zhi"></a>

```
POST https://api.tokenpay.me/v1/wallet/update
```

### 接口参数 <a href="#jie-kou-can-shu" id="jie-kou-can-shu"></a>

| 名称              | 位置     | 类型     | 必选 | 说明                                                                                                          |
| --------------- | ------ | ------ | -- | ----------------------------------------------------------------------------------------------------------- |
| app\_id         | header | string | 是  | 应用ID，示例值：`8e4b8c2e7cxxxxxxxx1a1cbd3d59e0bd`                                                                 |
| mch\_id         | body   | string | 是  | 商户ID，示例值：`12345678`                                                                                         |
| name            | body   | string | 否  | 钱包备注，在[监听钱包模式](https://apidoc.tokenpay.me/chinese/shuo-ming/zhi-fu-fang-shi)下，可用作标识`一用户一钱包`唯一信息，如`用户ID`     |
| wallet\_address | body   | string | 是  | 钱包地址，示例值：`TQjxEW2Z3pxxxxxxxxxxxxgJUrWXVAC92T`                                                               |
| chain           | body   | string | 是  | 所属公链，示例值：`TRON`、`ETHEREUM`、`BSC`[查看支持公链](https://apidoc.tokenpay.me/chinese/huo-bi/cha-xun-bi-zhong-xin-xi) |

#### 参数示例 <a href="#can-shu-shi-li" id="can-shu-shi-li"></a>

```json
{
  "mch_id": "12345678",
  "app_id": "8e4b8c2e7cxxxxxxxx1a1cbd3d59e0bd",
  "wallet_address": "TQjxEW2Z3pxxxxxxxxxxxxgJUrWXVAC92T",
  "chain": "TRON",
  "name": "28713"
}
```

### 接口返回 <a href="#jie-kou-fan-hui" id="jie-kou-fan-hui"></a>

| 名称          | 类型                                                                                                        | 必选    | 说明                                                                        |
| ----------- | --------------------------------------------------------------------------------------------------------- | ----- | ------------------------------------------------------------------------- |
| code        | integer                                                                                                   | true  | [业务状态码](https://apidoc.tokenpay.me/chinese/cuo-wu-ma/ye-wu-zhuang-tai-ma) |
| msg         | string                                                                                                    | true  | 状态说明                                                                      |
| request\_id | string                                                                                                    | true  |                                                                           |
| data        | [WalletDetail](https://apidoc.tokenpay.me/chinese/shuo-ming/shu-ju-jie-gou#jian-ting-qian-bao-xiang-qing) | false |                                                                           |

### 返回示例 <a href="#fan-hui-shi-li" id="fan-hui-shi-li"></a>

```json
{
    "code": 0,
    "msg": "ok",
    "request_id": "60eeeab2-7896-4f80-8088-4251d262dea6",
    "data": {
        "app_id": "8e4b8c2e7cxxxxxxxx1a1cbd3d59e0bd",
        "mch_id": "12345678",
        "name": "28713",
        "chain": "TRON",
        "wallet_address": "TQjxEW2Z3pxxxxxxxxxxxxgJUrWXVAC92T",
        "create_time": 1675236993,
        "last_time": 0
    }
}
```

{% tabs %}
{% tab title="Shell" %}

```sh
curl --location --request POST 'https://api.tokenpay.me/v1/wallet/update' \
--header 'Authorization: <Authorization>' \
--header 'User-Agent: tokenpay API (https://tokenpay.me)' \
--header 'Content-Type: application/json' \
--data-raw '<body data here>'
```

{% endtab %}

{% tab title="Go" %}

```go
package main

import (
   "fmt"
   "strings"
   "net/http"
   "io/ioutil"
)

func main() {

   url := "https://api.tokenpay.me/v1/wallet/update"
   method := "POST"

   payload := strings.NewReader(`<body data here>`)

   client := &http.Client {
   }
   req, err := http.NewRequest(method, url, payload)

   if err != nil {
      fmt.Println(err)
      return
   }
   req.Header.Add("Authorization", "<Authorization>")
   req.Header.Add("User-Agent", "tokenpay API (https://tokenpay.me)")
   req.Header.Add("Content-Type", "application/json")

   res, err := client.Do(req)
   if err != nil {
      fmt.Println(err)
      return
   }
   defer res.Body.Close()

   body, err := ioutil.ReadAll(res.Body)
   if err != nil {
      fmt.Println(err)
      return
   }
   fmt.Println(string(body))
}
```

{% endtab %}

{% tab title="PHP" %}

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
   CURLOPT_URL => 'https://api.tokenpay.me/v1/wallet/update',
   CURLOPT_RETURNTRANSFER => true,
   CURLOPT_ENCODING => '',
   CURLOPT_MAXREDIRS => 10,
   CURLOPT_TIMEOUT => 0,
   CURLOPT_FOLLOWLOCATION => true,
   CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
   CURLOPT_CUSTOMREQUEST => 'POST',
   CURLOPT_POSTFIELDS =>'<body data here>',
   CURLOPT_HTTPHEADER => array(
      'Authorization: <Authorization>',
      'User-Agent: tokenpay API (https://tokenpay.me)',
      'Content-Type: application/json'
   ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
```

{% endtab %}

{% tab title="Python" %}

```python
import http.client
import json

conn = http.client.HTTPSConnection("https://api.tokenpay.me")
payload = "<body data here>"
headers = {
   'Authorization': '<Authorization>',
   'User-Agent': 'tokenpay API (https://tokenpay.me)',
   'Content-Type': 'application/json'
}
conn.request("POST", "/v1/wallet/update", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```

{% endtab %}

{% tab title="Java" %}

```java
OkHttpClient client = new OkHttpClient().newBuilder()
   .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "<body data here>");
Request request = new Request.Builder()
   .url("https://api.tokenpay.me/v1/wallet/update")
   .method("POST", body)
   .addHeader("Authorization", "<Authorization>")
   .addHeader("User-Agent", "tokenpay API (https://tokenpay.me)")
   .addHeader("Content-Type", "application/json")
   .build();
Response response = client.newCall(request).execute();
```

{% endtab %}
{% endtabs %}
