# 1. İade (Toplu)

## **İade (Toplu) Servisi**

<mark style="color:green;">`POST`</mark> `{{Base Adres}}/api/paywall/payment/bulk/payment/refund`

{% hint style="info" %}
**Önemli:** Toplu iade servisini kullanabilmeniz için **Header** alanında **apikeypublic** ve **apiclientpublic** parametrelerini göndermeniz gerekmektedir.

[<mark style="color:green;">**PaymentAPI Adresi**</mark>](https://developer.paywall.one/ortam)
{% endhint %}

{% hint style="warning" %}
İade işlemleri, ödemelerin gerçekleştiği <mark style="color:red;">**gün sonrasında**</mark> gönderilmesi gereken işlemlerdir. Aynı gün kartlara gönderilmek istenen ödemeler için iade değil [iptal](https://developer.paywall.one/odeme-servisi/18.-toplu-islem-yontemi/2.-iptal/1.-iptal-toplu) servisi kullanılmalıdır
{% endhint %}

{% hint style="info" %}
Toplu ödemeler kapsamında gerçekleşen işlemleri, tek tek iade edebilirsiniz. Bunun için [iade](https://developer.paywall.one/odeme-servisi/9.-iade) servisini kullanmalısınız.
{% endhint %}

**Servise gönderilmesi gereken parametreler şu şekildedir:**

<table><thead><tr><th width="191">Parametre</th><th width="106">Tip</th><th width="126">Zorunlu</th><th width="336">Açıklama</th></tr></thead><tbody><tr><td>apikeypublic</td><td>string</td><td>Evet</td><td>Üye işyeri panelinden temin etmiş olduğunuz Public Key.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Evet</td><td>Üye işyeri panelinden temin etmiş olduğunuz Public Client.</td></tr></tbody></table>

**İptal Detayları:**

<table><thead><tr><th width="215">Parametre</th><th width="106">Tip</th><th width="117">Zorunlu</th><th width="336">Açıklama</th></tr></thead><tbody><tr><td>Date</td><td>DateTime</td><td>Evet</td><td>İade etmek istediğiniz toplu ödemenin gerçekleştirildiği tarih bilgisi</td></tr><tr><td>MerchantUniqueCode</td><td>string</td><td>Evet</td><td>Toplu ödeme anında verdiğiniz takip numaranız</td></tr></tbody></table>

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

{% tabs %}
{% tab title="JSON" %}
{% code lineNumbers="true" %}

```json5
{
    "Date": "2024-12-12",
    "MerchantUniqueCode": "8279c96e-2775-4ecf-b594-3cb8fb265f88"
}
```

{% endcode %}
{% endtab %}
{% endtabs %}

Servisten Dönen Parametreler

<table><thead><tr><th width="280">Parametre</th><th width="123.33333333333331">Tip</th><th>Açıklama</th></tr></thead><tbody><tr><td>ErrorCode</td><td>int</td><td>Hata kodu. İşlem başarılı ise '0' değerini döner.</td></tr><tr><td>Result</td><td>bool</td><td>İşlem başarılı ise <strong>true</strong>, hatalı ise <strong>false</strong> döner.</td></tr><tr><td>Message</td><td>string</td><td>İşlemle ilgili bilgi veya hata mesajını içerir.</td></tr><tr><td><mark style="color:orange;">Body</mark> > Result</td><td>bool</td><td>İş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</td></tr><tr><td><mark style="color:orange;">Body</mark> > TotalPaymentCount</td><td>int</td><td>Toplam işlem</td></tr></tbody></table>

**Servisten Dönen Örnek JSON**

{% tabs %}
{% tab title="JSON" %}
{% code lineNumbers="true" %}

```json
{
    "ErrorCodeType": 1,
    "ErrorMessage": null,
    "ErrorCode": 0,
    "Result": true,
    "Message": "Bulk payment created and enqueued",
    "Body": {
        "Result": true,
        "BulkPaymentId": 391,
        "TotalPaymentCount": 6
    }
}
```

{% endcode %}
{% endtab %}
{% endtabs %}