API REFERENCE
Kontostand abfragen
Diese API fragt den Kontostand des YabandPay-Wallets ab.
Tipp
Diese API kann nur vom Superadmin-Konto des Händlers aufgerufen werden. Bediener- und Kassiererkonten sind dazu nicht berechtigt.
| Parameter | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| user | String | UID des Superadmin-Kontos | |
| sign | String | Signature | Erforderlich |
| method | String | v3.MerchantBalance | Erforderlich |
| time | Long | Timestamp | Erforderlich |
- Parameter
| Parameter | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| command | String | getBalance | Erforderlich |
| currency | String | ISO-4217-Währungscode, z. B. EUR oder CHF | Erforderlich |
| nonce_string | String | Zufällige Zeichenfolge mit höchstens 32 Zeichen | Erforderlich |
Signaturbeispiel:
Die sortierten Parameter werden zu einer URL-ähnlichen Abfragezeichenfolge verkettet.
"command=getBalance¤cy=EUR&method=v3.MerchantBalance&nonce_string=tw5be5b7sry5prm96s&time=1708422208&user=036870"
Signieren Sie stringA mit secret_key.
Die resultierende Signatur lautet:
"YOUR_SIGNATURE"
Anfragebeispiel:
{
"user": "036870",
"sign": "YOUR_SIGNATURE",
"method": "v3.MerchantBalance",
"time": 1708422208,
"data": {
"command": "getBalance",
"nonce_string": "tw5be5b7sry5prm96s",
"currency": "EUR"
}
}
Antwortbeispiel:
{
"status": true,
"code": "200",
"data": {
"user": "036870",
"time": 1708422208,
"gateway_name": "YabandPay",
"wallet_id": "WA156227511825",
"currency": "EUR",
"available": "9999788.98",
"reserve": "200.00",
"usable": "9999988.98",
"deposit": "20.00"
},
"message": ""
}
Weitere Informationen:
Beschreibungen der Antwortparameter:
| Parameter | Typ | Beschreibung |
|---|---|---|
| user | String | UID des Superadmin-Kontos |
| time | String | Aktueller Zeitstempel |
| gateway_name | String | Name des Anbieters |
| wallet_id | String | Wallet-ID |
| currency | String | Währungscode, ISO 4217 |
| available | String | Verfügbares Guthaben |
| reserve | String | Rücklage |
| usable | String | Verfügbarer Betrag, berechnet als vailable - reserve |
| deposit | String | Eingefrorenes Guthaben |
