Wallet

Your organization has separate prepaid EUR and TRY balances. Partner orders currently use the EUR balance (payment.method: "wallet"); a TRY balance is not converted into EUR or used as a fallback. Order amounts are debited at creation time.

Get Wallet Balance

text

GET /wallet

API key only, no signature required.

Example Request

GET/v2/partners/wallet

curl "https://api.vignetim.com/v2/partners/wallet" \
  -H "X-API-Key: $VIGNETIM_API_KEY"

Response

json

{
	"currency": "EUR",
	"balanceMinor": "125000",
	"balance": 1250,
	"balances": [
		{ "currency": "EUR", "balanceMinor": "125000", "balance": 1250 },
		{ "currency": "TRY", "balanceMinor": "0", "balance": 0 }
	]
}

Field	Type	Description
`currency`	string	Wallet currency (`EUR`)
`balanceMinor`	string	Balance in minor units (cents), as a string
`balance`	number	Balance in major units (EUR)
`balances`	array	Separate EUR and TRY balances, each with `currency`, `balanceMinor`, and `balance`

Use balances to inspect both currencies. Partner orders debit EUR only. Use balanceMinor for exact arithmetic; balance is a convenience value.

Funding the Wallet

Partners cannot credit their own wallet through the API. The wallet is funded by bank transfer:

Transfer funds to the Vignetim account details provided during onboarding, referencing your organization.
The Vignetim back office posts the received transfer to the balance matching the receiving account's currency (credits are idempotent per organization, currency, and transfer reference).
The new balance is visible on GET /wallet immediately after posting.

Contact your Vignetim account manager for transfer instructions or to confirm a pending top-up.

Insufficient Balance

If an order paid with wallet exceeds your balance, POST /orders fails with a 422 and nothing is charged:

json

{
	"statusCode": 422,
	"code": "INSUFFICIENT_WALLET_BALANCE",
	"message": "Insufficient wallet balance: have 1250, need 4990 (minor units).",
	"balanceMinor": "1250",
	"requiredMinor": "4990"
}

balanceMinor and requiredMinor are EUR minor units (cents). If the request carried an idempotency key, the claim is released immediately, so the same key can be retried after topping up.