Dokumentation/API-Referenz

API REFERENCE

Kontostand abfragen

POSThttps://mapi.yabandpay.com/Payments
Live API
API PLAYGROUND · Live API

Kontostand abfragen

POSThttps://mapi.yabandpay.com/Payments
Automatically signed with your credentials

Request parameters3

Required fields first

余额查询

commandRequiredstringdata.commandgetBalance
currencyRequiredstringdata.currency货币代码,ISO 4217,例如EUR,CHF
nonce_stringRequiredstringdata.nonce_string随机字符串,不长于32位

Credentials stay on this page. Your secret key is never stored or sent to the documentation server.

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.

ParameterTypBeschreibungErforderlich
userStringUID des Superadmin-Kontos
signStringSignatureErforderlich
methodStringv3.MerchantBalanceErforderlich
timeLongTimestampErforderlich
  • Parameter
ParameterTypBeschreibungErforderlich
commandStringgetBalanceErforderlich
currencyStringISO-4217-Währungscode, z. B. EUR oder CHFErforderlich
nonce_stringStringZufällige Zeichenfolge mit höchstens 32 ZeichenErforderlich

Signaturbeispiel:

Die sortierten Parameter werden zu einer URL-ähnlichen Abfragezeichenfolge verkettet.

"command=getBalance&currency=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:
ParameterTypBeschreibung
userStringUID des Superadmin-Kontos
timeStringAktueller Zeitstempel
gateway_nameStringName des Anbieters
wallet_idStringWallet-ID
currencyStringWährungscode, ISO 4217
availableStringVerfügbares Guthaben
reserveStringRücklage
usableStringVerfügbarer Betrag, berechnet als vailable - reserve
depositStringEingefrorenes Guthaben