20. Satış/Harcama İade

Gerçekleştirilen bir satın alma işleminin iadesini gerçekleştirmek amacıyla bu servis kullanılmalıdır.

Satın Alma İadesi Başlat

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

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	Sisteme erişim için gerekli olan genel anahtar bilgisidir.
apiclientpublic	string	Evet	Servise erişim yapan istemciye ait genel kimlik bilgisidir.

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": "01034c7e-a1b8-4ca5-827e-583cb4385b54",
        "WalletId": "30bac1c0-ad6b-4c50-a52e-1b34f9b487a7",
        "TransactionType": "Refund",
        "Amount": 1.00,
        "GiftAmount": null,
        "Description": "Refund of Purchase Jeannette Nolan",
        "ExternalReference": "Jeannette Nolan",
        "CreatedAt": "2025-04-28T13:46:52.6109788Z",
        "UpdatedAt": null,
        "BalanceAfterTransaction": 994.00,
        "SourceWalletId": null,
        "DestinationWalletId": null,
        "GiftBalanceId": null,
        "MainTransactionId": "2d2eba9b-f8a9-4482-8df3-2906b9577c6e",
        "UniqueCode": "97d9b40b-7d74-4279-8bb1-db9efd73c73d",
        "UsedGiftBalances": null,
        "CashbackAmount": 0
    },
    "Errors": [],
    "IsSuccess": true,
    "IsFailure": false
}

Servis Cevap

Parametre	Tip	Açıklama
IsFailure	bool	İşlemin başarısız olup olmadığını gösterir. (true: başarısız, false: başarılı)
IsSuccess	bool	İşlemin başarılı olup olmadığını gösterir. (true: başarılı, false: başarısız)
Errors	Array	İşlem sırasında oluşan hata mesajları listesidir.
Value	Array<Items>	İşlem sonucunda dönen veri listesidir.

Servis Cevap (Value)

Parametre	Tip	Açıklama
Id	Guid	İşleme ait sistem tarafından atanmış benzersiz kimlik numarasıdır.
WalletId	String	İşlemi gerçekleştiren cüzdanın kimlik bilgisidir.
TransactionType	String	Gerçekleştirilen işlemin türünü belirtir. (Örneğin: ödeme, iade)
Amount	Decimal	Gerçekleştirilen işlemde kullanılan toplam tutardır.
GiftAmount	Decimal	İşlemde hediye bakiyeden kullanılan tutardır.
Description	String	İşleme ait açıklama bilgisidir.
ExternalReference	String	İşleme dış sistemlerde verilen referans kodudur.
CreatedAt	DateTime	İşlemin oluşturulduğu tarih ve saat bilgisi.
UpdatedAt	DateTime	İşlem kaydının son güncellendiği tarih ve saat bilgisi.
BalanceAfterTransaction	Decimal	İşlem sonrası cüzdandaki toplam bakiye bilgisidir.
SourceWalletId	String	İşlemi başlatan cüzdan kimliğidir.
DestinationWalletId	String	İşlemde gönderimin yapıldığı hedef cüzdan kimliğidir.
GiftBalanceId	Guid	İşlemde kullanılan hediye bakiyesinin kimlik numarasıdır.
MainTransactionId	Guid	İlgili ana işleme ait kimlik numarasıdır.
UniqueCode	String	İşleme özel oluşturulmuş benzersiz kod bilgisidir.
UsedGiftBalances	List	İşlemde kullanılan hediye bakiye detaylarının listesidir.
CashbackAmount	Decimal	İşlem sonunda kazanılan cashback (nakit iade) tutarıdır.