Wallet

Your organization has a prepaid EUR wallet that can be used as a payment method for orders (payment.method: "wallet"). Order amounts are debited from the wallet 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
}

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)

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 your wallet (credits are idempotent per 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.