Consulter le Solde
Consulter le Solde du Compte
Adresse de Requête
GET /v1/balance
Authentification
Utilise l'authentification HTTP basique. Ajoutez Authorization dans l'en-tête HTTP :
Authorization: Basic ${base64_auth_string}
Authorization: Basic ${base64_auth_string}
Afficher ce bloc de code dans la fenêtre flottante
Le base64_auth_string est généré par : base64(dev_key:dev_secret)
Exemple de Requête
En-tête de Requête
GET /v1/balance HTTP/1.1
Authorization: Basic amlndWFuZ2RldjpkZXZfc2VjcmV0
GET /v1/balance HTTP/1.1
Authorization: Basic amlndWFuZ2RldjpkZXZfc2VjcmV0
Afficher ce bloc de code dans la fenêtre flottante
Corps de Requête
Aucun
Paramètres de Requête
Aucun
Paramètres de Réponse
Réponse Réussie
| Champ | Type | Option | Description |
|---|---|---|---|
| balance10000 | Integer | Obligatoire | Solde normal, valeur entière multipliée par 10000 |
| gift_balance10000 | Integer | Obligatoire | Solde cadeau, valeur entière multipliée par 10000 |
| balance | Number | Obligatoire | Solde normal, virgule flottante |
| gift_balance | Number | Obligatoire | Solde cadeau, virgule flottante |
| total_balance10000 | Integer | Obligatoire | Solde total, somme du solde normal et du solde cadeau, valeur entière multipliée par 10000 |
| total_balance | Number | Obligatoire | Solde total, somme du solde normal et du solde cadeau, virgule flottante |
{
"balance10000": 123456,
"gift_balance10000": 20000,
"balance": 12.3456,
"gift_balance": 2,
"total_balance10000": 143456,
"total_balance": 14.3456
}
{
"balance10000": 123456,
"gift_balance10000": 20000,
"balance": 12.3456,
"gift_balance": 2,
"total_balance10000": 143456,
"total_balance": 14.3456
}
Afficher ce bloc de code dans la fenêtre flottante
Il est recommandé aux appelants d'utiliser en priorité les champs balance10000, gift_balance10000 et total_balance10000 pour formater le solde eux-mêmes, afin d'éviter les problèmes de précision en virgule flottante.
Réponse Échouée
Le code de statut HTTP est 4xx ou 5xx, le corps de la réponse contient les champs suivants :
| Champ | Type | Option | Description |
|---|---|---|---|
| code | int | Obligatoire | Code d'erreur, voir Codes d'Erreur pour plus de détails |
| message | String | Obligatoire | Détails de l'erreur |
{
"code": 2001,
"message": "invalid token"
}
{
"code": 2001,
"message": "invalid token"
}
Afficher ce bloc de code dans la fenêtre flottante
Codes d'Erreur
| Code d'Erreur | HTTP Code | Description |
|---|---|---|
| 1000 | 500 | Erreur interne, veuillez réessayer plus tard |
| 2001 | 401 | Échec d'authentification, le token correct n'a pas été fourni, ou le commerçant correspondant au token n'existe pas |
| 2002 | 401 | Échec d'authentification, le token a expiré ou a été désactivé |
| 2002 | 403 | Le commerçant a été supprimé |
