Cüzdan (Wallet)

Kurumunuzun, siparişlerde ödeme yöntemi olarak kullanılabilen ön ödemeli bir EUR cüzdanı vardır (payment.method: "wallet"). Sipariş tutarları, sipariş oluşturulduğu anda cüzdandan tahsil edilir.

Cüzdan Bakiyesini Getir

text

GET /wallet

Yalnızca API anahtarı gerekir, imza gerekmez.

Örnek İstek (Example Request)

GET/v2/partners/wallet

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

Yanıt

json

{
	"currency": "EUR",
	"balanceMinor": "125000",
	"balance": 1250
}

Alan	Tür	Açıklama
`currency`	string	Cüzdan para birimi (`EUR`)
`balanceMinor`	string	Bakiye, alt birimde (kuruş) ve metin (string) olarak
`balance`	number	Bakiye, ana birimde (EUR)

Kesin hesaplamalar için balanceMinor kullanın; balance yalnızca kolaylık sağlayan bir değerdir.

Cüzdana Bakiye Yükleme

Partnerler API üzerinden kendi cüzdanlarına bakiye yükleyemez. Cüzdan banka transferi ile yüklenir:

Kurumunuzun adını referans göstererek, hesap açılışı sırasında paylaşılan Vignetim hesap bilgilerine transfer yapın.
Vignetim back office, gelen transferi cüzdanınıza işler (yüklemeler transfer referansı bazında idempotenttir).
Yeni bakiye, işlemin ardından GET /wallet üzerinde anında görünür.

Transfer talimatları için veya bekleyen bir yüklemeyi teyit etmek için Vignetim müşteri yöneticinizle iletişime geçin.

Yetersiz Bakiye

wallet ile ödenen bir sipariş bakiyenizi aşarsa, POST /orders 422 ile başarısız olur ve hiçbir tahsilat yapılmaz:

json

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

balanceMinor ve requiredMinor değerleri EUR alt birimidir (kuruş). İstek bir idempotency anahtarı taşıyorsa, ayrılan tutar anında serbest bırakılır; böylece bakiye yüklendikten sonra aynı anahtar yeniden denenebilir.