1. Tanımla

Belirli bir cüzdana blokeli bakiye tanımlamak için ilgili servisi kullanabilirsiniz.

Bakiye Blokla

POST{{WalletUrl}}/api/v1/wallet/balance/blocked

Not: Bu servisin kullanılabilmesi için apikeypublic ve apiclientpublic parametrelerinin Header alanına eklenmiş olması zorunludur.

WalletAPI Adresi

Gerekli header ve istek parametreleri:

Zorunlu header parametreleri

Parametre	Tip	Zorunlu	Açıklama
apikeypublic	string	Evet	Servise erişim için kullanılan genel anahtar bilgisidir.
apiclientpublic	string	Evet	Uygulamanın kimliğini temsil eden genel erişim anahtarıdır.

İstek gövdesi parametreleri

Parametre	Tip	Zorunlu	Açıklama
Id	guid	Evet	Bakiyesi bloke edilecek cüzdanın benzersiz tanımlayıcısı
Amount	decimal	Evet	Bloke edilecek tutar. Sıfırdan büyük olmalıdır
ExternalReference	string	Evet	Kendi sisteminizdeki işleme ait benzersiz referans numarası.
Description	string	Hayır	Bloke işlemine ait açıklama veya not

Servise gönderilecek örnek bir JSON dosyası şu şekildedir :

JSON

{
  "Amount": 1000,
  "Description": "string",
  "Id": "2ea244d1-6ed2-4eca-a84b-273c62f64606",
  "ExternalReference": "{{$guid}}"
}

Servisten dönen parametreler şu şekildedir:

Parametreler ve açıklamaları

Parametre	Tip	Açıklama
IsFailure	bool	İşlemin başarısız olup olmadığını belirtir. true ise hata olmuştur.
IsSuccess	​bool	İşlemin başarılı olup olmadığını belirtir. true ise başarıyla tamamlanmıştır.
Errors	Array	Oluşan hata/hatalar varsa detaylarını içeren dizi.
Value	Array	Başarılı yanıt durumunda dönen asıl veri içeriğini barındırır.
Id	Guid	Blokeli bakiye kimlik numarası
WalletId	Guid	Cüzdan kimlik numarası
Amount	decimal	Bloklanan tutar
Description	string	Bloklanan bakiye açıklaması
IsActive	bool	Blokeli tutarın aktiflik durumu
CreatedAt	DateTime	Kaydın oluşturulma tarihi
UpdatedAt	DateTime	Kaydın güncellenme tarihi

JSON

{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Id": "6ec397e1-3162-43d5-b4e5-98ae8e5c2914",
        "WalletId": "2ea244d1-6ed2-4eca-a84b-273c62f64606",
        "Amount": 1000,
        "Description": "string",
        "IsActive": true,
        "CreatedAt": "2025-08-20T15:26:08.3846533Z",
        "UpdatedAt": null
    }
}