19. 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

Servise gönderilmesi gereken parametreler şu şekildedir:

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.

Servis İstek - Json

{
  "ExternalReference": "{{externalReference}}",
  "RollbackFee": true,
  "RollbackCashback": true
}

Servis İstek

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

Servis Cevap - Json

{
    "Value": {
        "Id": "5b451d65-3e18-415b-9cb0-b7999fc67a7e",
        "WalletId": "0e5439b8-efa5-43d3-91e9-3cc351cc6ecc",
        "TransactionType": "Cancel",
        "Amount": 1.00,
        "GiftAmount": null,
        "Description": "Cancel of Purchase Eddie Leuschke",
        "ExternalReference": "Eddie Leuschke",
        "CreatedAt": "2025-05-01T18:14:29.6583832Z",
        "UpdatedAt": null,
        "BalanceAfterTransaction": 30.00,
        "SourceWalletId": null,
        "DestinationWalletId": null,
        "GiftBalanceId": null,
        "MainTransactionId": "13d23fb6-effa-4776-8385-c345d24b737e",
        "UniqueCode": "dcfe720f-a77a-46f0-b6f2-0deda66425ec",
        "UsedGiftBalances": null,
        "CashbackAmount": 0
    },
    "Errors": [],
    "IsSuccess": true,
    "IsFailure": false
}

Servis Cevap

Parametre	Tip	Açıklama
IsFailure	bool	Servis çağrısı başarısız olduysa true, aksi halde false döner.
IsSuccess	bool	Servis çağrısı başarılı olduysa true, aksi halde false döner.
Errors	Array	İşlem sırasında oluşan hata mesajlarını içerir.
Value	Array<Items>	Başarılı yanıt durumunda dönen veri listesidir.

Servis Cevap (Value)

Parametre	Tip	Açıklama
Id	Guid	İşlem için sistem tarafından oluşturulan benzersiz kimlik.
WalletId	String	İşlemin ait olduğu cüzdanın kimliği.
TransactionType	String	İşlemin türünü belirtir (örneğin ödeme, iade vb.).
Amount	Decimal	İşlemin toplam tutarı.
GiftAmount	Decimal	Hediye bakiyesinden kullanılan tutar.
Description	String	İşleme ait açıklama ya da not.
ExternalReference	String	Sistem dışı kaynaklardan gelen referans kodu.
CreatedAt	DateTime	İşlemin oluşturulduğu tarih/zaman.
UpdatedAt	DateTime	İşlemin son güncellendiği tarih/zaman.
BalanceAfterTransaction	Decimal	İşlem sonrası kalan cüzdan bakiyesi.
SourceWalletId	String	İşlemi başlatan cüzdanın kimliği (varsa).
DestinationWalletId	String	İşlemin gönderildiği cüzdan kimliği (varsa).
GiftBalanceId	Guid	Kullanılan hediye bakiyesi kaydının ID’si.
MainTransactionId	Guid	Bu işlem başka bir ana işleme bağlıysa o işlemin ID’si.
UniqueCode	String	İşlemi tanımlayan benzersiz kod.
UsedGiftBalances	List	Kullanılan hediye bakiyelerine dair liste.
CashbackAmount	Decimal	Bu işleme bağlı kazanılan cashback (iade) tutarı.