Available balance
const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/payment/ledger/balance';const options = { method: 'GET', headers: {'Wink-Version': '2.0', Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/payment/ledger/balance \ --header 'Authorization: Bearer <token>' \ --header 'Wink-Version: 2.0'Returns the ledger balance per currency for the given managing entity. This is the authoritative source of truth for the withdrawal flow. Hotels are denominated in their local/source currency (e.g., THB); other beneficiaries in the internal currency (USD). A balance may be NEGATIVE when Stripe acquiring/refund fees debited to the account exceed its credits; such a balance nets against future credits and is not withdrawable. Read the entry’s withdrawable flag rather than assuming a returned balance can be paid out.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Managing entity identifier (UUID)
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69Header Parameters
Section titled “Header Parameters”Responses
Section titled “Responses”Ledger balance per currency retrieved successfully; one entry per currency.
Ledger balance for a single currency. Hotels are denominated in source currency (e.g., THB); affiliates and other beneficiaries in internal currency (USD). The amount may be negative when Stripe acquiring/refund fees debited to the account exceed its credits; negative balances net against future credits and are not withdrawable.
object
Balance amount in the specified currency. Negative when fees debited to the account exceed its credits.
ISO 4217 currency code of the balance.
Whether this balance can be withdrawn – true only when the amount is strictly positive. The amount may be negative when Stripe acquiring/refund fees debited to the account exceed credits; negative balances net against future credits and are not withdrawable.
Example
[ { "amount": 45000, "currencyCode": "THB", "withdrawable": true }]Bad Request — missing or invalid request parameter or body
object
object
Example
Unauthorized — authentication is required or the session has expired
object
object
Example
Forbidden — authenticated but lacking the required permission or scope
object
object
Example
Not Found — the requested resource does not exist
object
object
Example
Method Not Allowed — the HTTP verb is not supported on this endpoint
object
object
Example
Conflict — the resource was modified by someone else since you read it; re-read it and retry with the new version
object
object
Example
Unsupported Media Type — use application/json
object
object
Example
Internal Server Error — an unexpected failure occurred on the server
object
object
Example
Service Unavailable — a downstream dependency is unreachable