2. İade (Liste)

Toplu iade servisi, liste halinde iletilen ödemelerinizi tek bir API çağrısıyla teslim alır ve sonucu size tek bir seferde geri bildirim (callback) ile döner.

İade (Liste) Servisi

POST {{Base Adres}}/api/paywall/payment/bulk/batch/refund

Önemli: Toplu iade servisini kullanabilmeniz için Header alanında apikeypublic ve apiclientpublic parametrelerini göndermeniz gerekmektedir.

PaymentAPI Adresi

İade işlemleri, ödemelerin gerçekleştiği gün sonrasında gönderilmesi gereken işlemlerdir. Aynı gün kartlara gönderilmek istenen ödemeler için iade değil iptal servisi kullanılmalıdır

Toplu ödemeler kapsamında gerçekleşen işlemleri, tek tek iade edebilirsiniz. Bunun için iade servisini kullanmalısınız.

Servise gönderilmesi gereken parametreler şu şekildedir:

Parametre	Tip	Zorunlu	Açıklama
apikeypublic	string	Evet	Üye işyeri panelinden temin etmiş olduğunuz Public Key.
apiclientpublic	string	Evet	Üye işyeri panelinden temin etmiş olduğunuz Public Client.

İptal Detayları:

Parametre	Tip	Zorunlu	Açıklama
Date	DateTime	Evet	İade etmek istediğiniz toplu ödemenin gerçekleştirildiği tarih bilgisi
MerchantUniqueCode	string	Evet	Toplu ödeme anında verdiğiniz takip numaranız

Servise gönderilecek örnek JSON ve örnek kodlar aşağıdaki gibidir:

JSON

{
    "Payments": [
        {
            "MerchantUniqueCode": "PWL-010101010101",
            "Date": "2025-01-01"
        },
        {
            "MerchantUniqueCode": "PWL-010101010102",
            "Date": "2025-01-01"
        },
        {
            "MerchantUniqueCode": "PWL-010101010103",
            "Date": "2025-01-01"
        },
        {
            "MerchantUniqueCode": "PWL-010101010104",
            "Date": "2025-01-01"
        },
        {
            "MerchantUniqueCode": "PWL-010101010105",
            "Date": "2025-01-01"
        },
        {
            "MerchantUniqueCode": "PWL-010101010106",
            "Date": "2025-01-01"
        },
        {
            "MerchantUniqueCode": "PWL-010101010107",
            "Date": "2025-01-01"
        },
        {
            "MerchantUniqueCode": "PWL-010101010108",
            "Date": "2025-01-01"
        },
        {
            "MerchantUniqueCode": "PWL-010101010109",
            "Date": "2025-01-01"
        },
        {
            "MerchantUniqueCode": "PWL-010101010110",
            "Date": "2025-01-01"
        },
        {
            "MerchantUniqueCode": "PWL-010101010111",
            "Date": "2025-01-01"
        },
        {
            "MerchantUniqueCode": "PWL-010101010112",
            "Date": "2025-01-01"
        },
        {
            "MerchantUniqueCode": "PWL-010101010113",
            "Date": "2025-01-01"
        },
        {
            "MerchantUniqueCode": "PWL-010101010114",
            "Date": "2025-01-01"
        },
        {
            "MerchantUniqueCode": "PWL-010101010115",
            "Date": "2025-01-01"
        },
        {
            "MerchantUniqueCode": "PWL-010101010116",
            "Date": "2025-01-01"
        },
        {
            "MerchantUniqueCode": "PWL-010101010117",
            "Date": "2025-01-01"
        },
        {
            "MerchantUniqueCode": "PWL-010101010118",
            "Date": "2025-01-01"
        },
        {
            "MerchantUniqueCode": "PWL-010101010119",
            "Date": "2025-01-01"
        },
    ],
    "CallbackUrl": "https://yourwebsite.com/paywall/callback"
}

Servisten Dönen Parametreler

Parametre	Tip	Açıklama
ErrorCode	int	Hata kodu. İşlem başarılı ise '0' değerini döner.
Result	bool	İşlem başarılı ise true, hatalı ise false döner.
Message	string	İşlemle ilgili bilgi veya hata mesajını içerir.
Body > Result	bool	İşlemin başarıyla teslim alınıp alınamadığını ifade eder. True olması durumda Paywall talebi başarıyla almış ve kuyruk mekanizmasına konumlandırmış demektir. Sonuçlar geri bildirim olarak iletilecektir
Body > TotalPaymentCount	int	Toplam işlem

Servisten Dönen Örnek JSON

JSON

{
    "ErrorCodeType": 1,
    "ErrorMessage": null,
    "ErrorCode": 0,
    "Result": true,
    "Message": "Batch refund created and enqueued",
    "Body": {
        "Result": true,
        "PaymentResults": [
            {
                "MerchantUniqueCode": "4049957f-520e-410b-8f6c-fedc9dac9a76",
                "Status": 1,
                "Message": "Added to bulk refund process",
                "BulkPaymentId": 2684,
                "ErrorMessage": null,
                "BulkPaymentJobId": 0
            },
            {
                "MerchantUniqueCode": "9d6d1cbf-4828-4654-87a8-9a1e763ad6a3",
                "Status": 1,
                "Message": "Added to bulk refund process",
                "BulkPaymentId": 2684,
                "ErrorMessage": null,
                "BulkPaymentJobId": 0
            },
            {
                "MerchantUniqueCode": "562a87ac-3320-421d-9920-90c4d30dec44",
                "Status": 1,
                "Message": "Added to bulk refund process",
                "BulkPaymentId": 2684,
                "ErrorMessage": null,
                "BulkPaymentJobId": 0
            }
        ]
    }
}