API REFERENCE
Saldo opvragen
Deze API vraagt het saldo van de YabandPay-wallet op.
Tip
Alleen superbeheerderaccounts van merchants mogen deze API aanroepen. Operator- en kassieraccounts zijn niet bevoegd.
API-URL:https://mapi.yabandpay.com/Payments
Methode:POST
POST gegevenstype:Json
| Parameter | Type | Beschrijving | Verplicht |
|---|---|---|---|
| user | String | UID van het superbeheerderaccount | |
| sign | String | Signature | Verplicht |
| method | String | v3.MerchantBalance | Verplicht |
| time | Long | Timestamp | Verplicht |
- Parameters
| Parameter | Type | Beschrijving | Verplicht |
|---|---|---|---|
| command | String | getBalance | Verplicht |
| currency | String | ISO 4217-valutacode, bijvoorbeeld EUR of CHF | Verplicht |
| nonce_string | String | Willekeurige tekenreeks van maximaal 32 tekens | Verplicht |
Voorbeeld van een handtekening:
Parameters op volgorde samengevoegd tot een querystring in URL-stijl
"command=getBalance¤cy=EUR&method=v3.MerchantBalance&nonce_string=tw5be5b7sry5prm96s&time=1708422208&user=036870"
Onderteken stringA met secret_key
De gegenereerde handtekening is:
"YOUR_SIGNATURE"
Voorbeeld van een aanvraag:
{
"user": "036870",
"sign": "YOUR_SIGNATURE",
"method": "v3.MerchantBalance",
"time": 1708422208,
"data": {
"command": "getBalance",
"nonce_string": "tw5be5b7sry5prm96s",
"currency": "EUR"
}
}
Voorbeeld van een antwoord:
{
"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": ""
}
Aanvullende informatie:
Beschrijving van antwoordparameters:
| Parameter | Type | Beschrijving |
|---|---|---|
| user | String | UID van het superbeheerderaccount |
| time | String | Huidige tijdstempel |
| gateway_name | String | Naam van de instelling |
| wallet_id | String | Wallet-ID |
| currency | String | Valutacode, ISO 4217 |
| available | String | Beschikbaar saldo |
| reserve | String | Gereserveerd saldo |
| usable | String | Besteedbaar bedrag, gelijk aan vailable - reserve |
| deposit | String | Geblokkeerd saldo |
