Wallet
Read your prepaid balance and pay draft orders from it — wallet partners only.
Partners with a prepaid wallet linked to their account (arranged with vinieta.md)
can read the balance and pay their own draft orders from it — no card leg, no
confirm-order. Both endpoints are signed exactly like every other call.
Get Balance
Section titled “Get Balance”Endpoint
Section titled “Endpoint”POST /v1/get-balance
Body: {} — sign the literal {} string. Read-only; poll freely.
Request Body Examples
Section titled “Request Body Examples”{}Response Body Examples
Section titled “Response Body Examples”{ "balance": 1250.5, "currency": "MDL", "wallets": { "online": 1250.5, "insurance": 0, "promo": 0 }, "updated_at": "2026-07-08T10:00:00.000Z"}balance is the total spendable amount for API products
(wallets.online + wallets.promo). Wire-transfer top-ups are credited to the
online wallet.
Each order is paid from a single wallet (promo first if you hold promotional credit, then online). With funds split across wallets, check the
walletsbreakdown, not justbalance.
Pay Order From Balance
Section titled “Pay Order From Balance”Endpoint
Section titled “Endpoint”POST /v1/pay-order-from-balance
Pays one of your own draft orders entirely from one wallet — promo
first, then online. Partial or cross-wallet cover is not supported (there is no
card leg to charge a remainder).
On success the response is the same order object as
get-order, now in paid status, and issuance proceeds
exactly as after confirm-order — including the
processing → completed flow for vignette:eu.
Body Parameters
Section titled “Body Parameters”| Name | Type | Required | Description |
|---|---|---|---|
id |
string |
yes | Order ID |
Request Body Examples
Section titled “Request Body Examples”{ "id": "EUV001002ABC"}Response Body Examples
Section titled “Response Body Examples”{ "id": "EUV001002ABC", "status": "paid", "description": "Vinietă Europa, BG, 7 zile, BMW X7 ISG313", "start_date": "2026-06-10", "end_date": "2026-06-16", "price": 179.15, "currency": "MDL"}Errors
Section titled “Errors”| Code | Error | Meaning |
|---|---|---|
400 |
Insufficient balance |
Wallet does not cover the full price; order stays draft |
400 |
Order is not payable (status ...) |
Order is not draft (also what a double-pay returns) |
400 |
Balance cannot be applied to this order |
The order’s products are not wallet-eligible |
403 |
Balance spending is disabled |
Wallet payments temporarily off |
403 |
No wallet account linked to this partner |
No wallet linked to your partner account |
404 |
Order not found |
Unknown id, or an order that is not yours |