Skip to content
vinieta.md Developers

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.

POST /v1/get-balance

Body: {} — sign the literal {} string. Read-only; poll freely.

JSON
{}
JSON
{
"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 wallets breakdown, not just balance.

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 processingcompleted flow for vignette:eu.

Name Type Required Description
id string yes Order ID
JSON
{
"id": "EUV001002ABC"
}
JSON
{
"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"
}
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