12. İptal & İade

İptal & İade servisi, hem iptal işlemlerini hem de iade işlemlerini aynı anda sağlamaktadır

İptal & İade

POST {{Private Base Address}}/api/paywall/private/revert

Yukarıda verilmiş olan adrese istek atmanız yeterli olacaktır. Test ortamı ve Gerçek ortam için 'Base Address' istediğiniz gibi kullanabilirsiniz.

Önemli: İptal & İade servisini kullanabilmeniz için 'Header' alanında 'apikeyprivate' ve 'apiclientprivate' parametrelerini göndermeniz gerekmektedir. PaymentPrivateAPI Adresi

İptal & İade servisi, gelen talebi aldıktan sonra ödemenin yapıldığı günü kontrol eder ve aşağıdaki akışlardan uygun olanını uygular:

1. Eğer talep, ödemenin yapıldığı gün gönderilmişse iptal işlemi gerçekleştirilir

2. Eğer talep, ödemenin yapıldığı günden sonra gönderilmişse iade işlemi gerçekleştirilir.

   1. Eğer talepte belirtilen Amount değeri sıfır değilse ve işlem tutarından farklı ise, kısmi iade işlemi gerçekleştirilir.

Parametre	Tip	Zorunlu	Açıklama
apikeyprivate	string	Evet	Üye işyeri panelinden temin etmiş olduğunuz Private Key.
apiclientprivate	string	Evet	Üye işyeri panelinden temin etmiş olduğunuz Private Client.

Servise gönderilmesi gereken parametreler şu şekildedir :

Parametre	Tip	Zorunlu	Açıklama
UniqueCode	Guid	Evet	Ödeme başlatma sonrasında Paywall tarafından dönen API cevabında, ilgili işlemin Paywall'daki UniqueCode karşılığı bulunmaktadır. Bu bilgi tarafınızda saklanmalıdır
MerchantUniqueCode	string	Evet	Ödeme başlatma için gönderilen istek içerisindeki MerchantUniqueCode ile aynı değer olmalıdır. Bu kod sizin tarafınızdan işleme ait verilen tekil değerdir. İptal/İade/Ödeme Sorgulama işlemlerinin hepsinde bir ödemeyi tekilleştirmeniz ve takip etmeniz için kullanılmaktadır.
Amount	decimal	Hayır	Amount parametresi 0 gönderilirse, işlem ana tutar üzerinden gerçekleştirilir. Eğer Amount değer, var olan işlem tutarından farklı gönderilirse Kısmi İade olarak işlenir
MarketPlace:DeleteExistingRecords	bool	Hayır	Pazaryeri kapsamında ilgili ödemenin hakediş onayının verilmesi durumunda, bu parametre true gönderilmelidir. True gönderilmesi durumunda var olan hakedişler, iptal emrinin başarılı olması sonrasında silinir

Json

{
    "UniqueCode": "1111-1111-1111-1111", // Ödeme sonucunda Paywall'dan dönmektedir
    "MerchantUniqueCode": "ABCD-EFGH-JKLP-MNBV",
    "Amount": 0,
    "MarketPlace": { // nullable
        "DeleteExistingRecords": false
    }
}

Servisten dönen cevap:

Parametre	Tip	Açıklama
ErrorCode	int	Hata kodu. İşlem başarılı ise '0' değerini döner.
Result	bool	True ya da false değeri döner. İşlem başarılı iste 'true' değerini döner
Message	string	İşlem hatalıysa, bu hataya dair belirtilen mesajdır, locale parametresine göre dil desteği sunar.

Json

{
    "ErrorCode": 0,
    "Result": true,
    "Message": "Success",
    "Body": null
}