> For the complete documentation index, see [llms.txt](https://apidoc.tokenpay.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidoc.tokenpay.me/fr-fr/devise/demande-de-solde.md).

# Demande de solde

{% hint style="info" %}
ASTUCE (TIP)

Vérifiez le solde du compte et le statut en temps réel.
{% endhint %}

#### Adresse de l'interface (Interface address)

```
POST https://api.tokenpay.me/v1/merchant/balance
```

#### Paramètres de l'interface (Interface parameters)

| Nom      | Emplacement | Type   | Requis | Description                                                                                                        |
| -------- | ----------- | ------ | ------ | ------------------------------------------------------------------------------------------------------------------ |
| mch\_id  | body        | string | Oui    | ID du marchand, valeur d'exemple :`12345678`                                                                       |
| chain    | body        | string | Oui    | Chaîne publique propriétaire, valeur d'exemple : `TRON`                                                            |
| currency | body        | string | Oui    | Devise, valeur d'exemple : `TRX`. [Voir les devises prises en charge](/fr-fr/devise/informations-sur-la-devise.md) |

#### Retour de l'interface (Interface return)

| **Nom**     | **Type** | **Description**                                                       | **Description**                                                                             |
| ----------- | -------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| code        | integer  | [Code de statut du service](/fr-fr/code-derreur/code-de-statut.md)    | Code de statut du service. 0 : succès, non 0 : indique la cause spécifique, référence `msg` |
| msg         | string   | Message de service de statut                                          | Message de service de statut                                                                |
| request\_id | string   | ID de la requête                                                      | ID de la requête                                                                            |
| data        | array    | [Objet solde du marchand](/fr-fr/description/structure-de-donnees.md) | Contenu                                                                                     |

#### Exemple de retour (Return example)

```json
{
    "code": 0,
    "msg": "ok",
    "request_id": "08250916-a677-4a36-a090-323807ac644c",
    "data": {
     "merchant_id": 167,
        "mch_id": "12345678",
        "network": "TRC20",
        "chain": "TRON",
        "balance": "54670000",
        "currency": "USDT",
        "decimal": 6,
        "create_time": 1724237814113,
        "modify_time": 1724239248394,
        "cash_time": 0
    }
}
```

#### Exemple de code (Example code)

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

```sh
curl --location --request GET 'https://api.tokenpay.me/v1/merchant/balance
--header 'Authorization: '
--header 'User-Agent: Tokenpay API (https://tokenpay.me)'
--header 'Content-Type: application/json'
--data-raw ''
```

{% endtab %}

{% tab title="Go" %}

```go
package main

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

func main() {

   url := "https://api.tokenpay.me/v1/merchant/balance"
   method := "GET"

   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/merchant/balance',
   CURLOPT_RETURNTRANSFER => true,
   CURLOPT_ENCODING => '',
   CURLOPT_MAXREDIRS => 10,
   CURLOPT_TIMEOUT => 0,
   CURLOPT_FOLLOWLOCATION => true,
   CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
   CURLOPT_CUSTOMREQUEST => 'GET',
   CURLOPT_POSTFIELDS =>'<body data here>',
   CURLOPT_HTTPHEADER => array(
      'Authorization: <Authorization>',
      'User-Agent: Tokenpay API (https://api.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.io")
payload = "<body data here>"
headers = {
   'Authorization': '<Authorization>',
   'User-Agent': 'TokenpayAPI (https://tokenpay.io)',
   'Content-Type': 'application/json'
}
conn.request("GET", "/v1/merchant/balance", 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/merchant/balance")
   .method("GET", body)
   .addHeader("Authorization", "<Authorization>")
   .addHeader("User-Agent", "Tokenpay API (https://tokenpay.io)")
   .addHeader("Content-Type", "application/json")
   .build();
Response response = client.newCall(request).execute();
```

{% endtab %}
{% endtabs %}

<br>
