20. Satış/Harcama İptal

Bir satın alma işlemini iptal etmek amacıyla bu servis kullanılmalıdır.

Satış/Harcama İptal

POST{{WalletUrl}}/api/v1/wallet/purchase/cancel

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	API erişimi için kullanılan genel anahtar.
apiclientpublic	string	Evet	İstemci uygulamasını tanımlayan genel anahtar.

İstek gövdesi parametreleri

Parametre	Tip	Zorunlu	Açıklama
ExternalReference	string	Hayır	Satış/Harcama işlemine ait takip numarası. İşlemin gerçekleştiği anda sizin tarafınızdan verilen değerdir
RollbackFee	bool	Evet	İlgili işlem sonucunda uygulanan (uygulandıysa) komisyonlar geri çekilsin mi?
RollbackCashback	bool	Hayır	İlgili işlem sonucunda uygulanan (uygulandıysa) cashback geri çekilsin mi?

İş Kuralları

• ExternalReference değerine ait Merchant kapsamında en az bir işlem kaydı bulunmalıdır.

• İptal edilecek işlem grubunda Purchase veya GiftBalanceUsed tipinde bir işlem bulunmalıdır.

• Aynı ExternalReference için daha önce iptal veya iade işlemi yapılmışsa tekrar işleme alınamaz.

• Satın alma iptali yalnızca aynı gün içinde yapılabilir. İşlem kayıtlarının tamamı farklı bir tarihe aitse iptal talebi reddedilir.

• Aynı ExternalReference için 2 saniye içinde tekrar gönderilen iptal istekleri reddedilir.

• İptal işlemi sonrasında satın alma işlemine ait bakiye hareketleri geri alınır.

• Aktif komisyon geri alma seçeneği varsa tahsil edilen komisyon tutarı iade edilir ve ayrı bir komisyon iptal kaydı oluşturulur.

• Aktif cashback geri alma seçeneği varsa kazanılmış cashback tutarları geri alınır ve cashback iptal kaydı oluşturulur.

• Hediye bakiye kullanılarak yapılan satın alma işlemlerinin iptali sonrasında kullanılan hediye bakiyeler cüzdana geri yüklenir.

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

JSON

{
  "ExternalReference": "bea70a60-c631-4c3e-963a-6188ef449601",
  "RollbackFee": true,
  "RollbackCashback": true
}

Servisten dönen parametreler şu şekildedir:

Parametreler ve açıklamaları

Parametre	Tip	Açıklama
Id	Guid	İşleme ait sistem tarafından üretilen benzersiz kimlik numarasıdır. UUID formatındadır.
WalletId	String	İşlemin yapıldığı cüzdanın sistemdeki kimlik numarasıdır. Hangi cüzdanla ilişkili olduğunu gösterir.
Alias	String	İşlemin yapıldığı cüzdanın alias'ı
TransactionType	String	İşlemin tipini belirtir. Örneğin "Ödeme", "İade", "Transfer" gibi işlemleri tanımlar.
Amount	Decimal	Gerçekleştirilen işlemin tutarıdır. Para birimi üzerinden ifade edilir.
GiftAmount	Decimal	İşlemde kullanılan hediye bakiye miktarıdır. Normal bakiyeden farklı olarak promosyonel kullanımı temsil eder.
Description	String	İşleme dair açıklayıcı bilgidir. Kullanıcı tarafından veya sistem tarafından yazılabilir.
ExternalReference	String	İşleme dış kaynaklı bir sistem üzerinden verilen referans numarasıdır. Genellikle entegrasyon sistemleri için kullanılır.
CreatedAt	DateTime	İşlemin oluşturulduğu tarih ve saat bilgisidir. UTC veya sistem saatine göre kaydedilir.
UpdatedAt	DateTime	İşlemin en son güncellendiği tarih ve saat bilgisidir. Bir değişiklik olduğunda güncellenir.
BalanceAfterTransaction	Decimal	İşlem gerçekleştikten sonra cüzdanda kalan bakiye miktarıdır. Hesap güncellemeleri sonrası değeri ifade eder.
SourceWalletId	Guid	Transfer işlemlerinde kaynak cüzdanın tanımlayıcısı
DestinationWalletId	Guid	Transfer işlemlerinde hedef cüzdanın tanımlayıcısı.
GiftBalanceId	Guid	Varsa işlemle ilişkili hediye bakiye kaydının tanımlayıcısı.
MainTransactionId	Guid	Varsa bu işlemin bağlı olduğu ana işlemin tanımlayıcısı
UniqueCode	String	İşleme ait benzersiz kod
UsedGiftBalances	array	İşlemde kullanılan hediye bakiyelerin listesi
UsedGiftBalances > Id	guid	Kullanılan hediye bakiye kaydının benzersiz tanımlayıcısı
UsedGiftBalances > Amount	decimal	Bu işlemde kullanılan hediye bakiye tutarı
UsedGiftBalances > ExpirationDate	datetime	Hediye bakiyenin son kullanma tarihi. null ise süresizdir
UsedGiftBalances > IsUnlimited	bool	ExpirationDate değeri null ise true döner, hediye bakiyenin süresiz olduğunu belirtir
UsedGiftBalances > Description	string	Hediye bakiyeye ait açıklama veya not
CashbackAmount	decimal	Varsa işleme ait cashback tutarı

JSON

{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Id": "e1638d79-b78b-4052-934d-9ff49318a981",
        "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
        "Alias": "2816220769",
        "TransactionType": "Cancel",
        "Amount": 10.00,
        "GiftAmount": null,
        "Description": "Cancel of Purchase 4dcac110-5511-4cdf-9047-c27bfdb203fb",
        "ExternalReference": "4dcac110-5511-4cdf-9047-c27bfdb203fb",
        "CreatedAt": "2025-08-20T11:57:27.0020678Z",
        "UpdatedAt": null,
        "BalanceAfterTransaction": 100.00,
        "SourceWalletId": null,
        "DestinationWalletId": null,
        "GiftBalanceId": null,
        "MainTransactionId": "24d912c2-11b1-4fdf-b0e7-6483e526e523",
        "UniqueCode": "744ee08b-33c2-4e5c-be07-336798b08fce",
        "UsedGiftBalances": [
            {
                "Id": "aa230ce5-127d-44a0-b480-7f9c4a24a9fd",
                "Amount": 5.00,
                "ExpirationDate": "2025-12-31T23:59:59Z",
                "IsUnlimited": false,
                "Description": "Hoşgeldin bonusu"
            }
        ],
        "CashbackAmount": 0.00
    }
}