> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tahsilat.com/llms.txt
> Use this file to discover all available pages before exploring further.

# İade Talebi Oluşturma

> Modern ödeme altyapısı için güçlü ve esnek API çözümü

Ödemelerinizin iade işlemlerini yönetmek için Tahsilat API üzerinden iade talepleri oluşturabilirsiniz. İade talepleri, tamamlanmış ödemelerin geri alınmasını sağlar.

***

<Note>
  Oluşturulan iade ya da kısmi iade talepleri sonuçlanana kadar mevcut işlem için tekrardan iade talebi oluşturulamaz. Bu nedenle, iade işlemlerinin durumunu kontrol etmek önemlidir.
</Note>

<Warning>
  Tutar gönderilmediği takdirde, iade tutarı işlem tutarı ile aynı olacaktır. Ancak, iade tutarını belirlemek için `amount` parametresini kullanmanız önerilir.
</Warning>

<br />

İstek:

<CodeGroup>
  ```php PHP theme={null}
  $tahsilat = new TahsilatClient('sk_test_rwwg...');

  $transaction = $tahsilat->transactions->refund([
      'transaction_id' => 12345678912345,
      'amount' => 10050,
      'description' => 'Test refund description',
  ]);
  ```

  ```csharp .NET theme={null}
  var tahsilat = new TahsilatClient("sk_test_rwwg...");

  var request = new RefundCreateRequest
   {
       TransactionId = 12345678912345,
       Amount = 10050,
       Description = "Test refund description"
   };

  var response = await tahsilat.Transactions.RefundAsync(request);
  ```

  ```curl cURL theme={null}
  curl -L 'https://api.tahsilat.com/v1/transaction/refund' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -H 'Accept-Language: tr' \
  -H 'Authorization: Bearer {access_token}' \
  -d 'transaction_id=1234567891234' \
  -d 'amount=61900' \
  -d 'description=Test Refund'
  ```
</CodeGroup>

Yanıt:

<CodeGroup>
  ```php PHP theme={null}
  ^ Tahsilat\Resource\Refund {
      "status": true
      "message": "İade talebi başarıyla oluşturuldu. Güvenlik incelemesi tamamlandıktan sonra iade işlemi gerçekleştirilecektir."
      "errors": []
      "error_code": null
      "data": null
  }
  ```

  ```csharp .NET theme={null}
  {
  	"Status": true,
  	"Message": "İade talebi başarıyla oluşturuldu. Güvenlik incelemesi tamamlandıktan sonra iade işlemi gerçekleştirilecektir.",
  	"ErrorCode": null,
  	"Data": null
  }
  ```
</CodeGroup>

## Zorunlu ve İsteğe Bağlı Parametreler

<ResponseField name="transaction_id" type="integer" required>
  Ödeme ile ilişkili işlem ID'si. Bu değer, Tahsilat API tarafından oluşturulan benzersiz bir kimliktir ve her işlem için gereklidir.
</ResponseField>

<ResponseField name="amount" type="integer" required>
  İade edilecek tutar. Bu parametre isteğe bağlıdır, ancak iade tutarını belirlemek için önerilir. Gönderilmediği takdirde, iade tutarı işlem tutarı ile aynı olacaktır.
</ResponseField>

<ResponseField name="description" type="string" required>
  İade talebi için zorunlu açıklama. Bu parametre, iade işleminin nedenini belirtmek için kullanılabilir.
</ResponseField>

<div className="panels">
  <Panel>
    İstek

    <CodeGroup>
      ```php PHP theme={null}
      $tahsilat = new TahsilatClient('sk_test_rwwg...');

      $transaction = $tahsilat->transactions->refund([
          'transaction_id' => 12345678912345,
          'amount' => 10050,
          'description' => 'Test refund description',
      ]);
      ```

      ```csharp .NET theme={null}
      var tahsilat = new TahsilatClient("sk_test_rwwg...");

      var request = new RefundCreateRequest
      {
          TransactionId = 12345678912345,
          Amount = 10050,
          Description = "Test refund description"
      };

      var response = await tahsilat.Transactions.RefundAsync(request);
      ```

      ```curl cURL theme={null}
      curl -L 'https://api.tahsilat.com/v1/transaction/refund' \
      -H 'Content-Type: application/x-www-form-urlencoded' \
      -H 'Accept-Language: tr' \
      -H 'Authorization: Bearer {access_token}' \
      -d 'transaction_id=1234567891234' \
      -d 'amount=61900' \
      -d 'description=Test Refund'
      ```
    </CodeGroup>

    <br />

    Yanıt

    <CodeGroup>
      ```php PHP theme={null}
      ^ Tahsilat\Resource\Refund {
          "status": true
          "message": "İade talebi başarıyla oluşturuldu. Güvenlik incelemesi tamamlandıktan sonra iade işlemi gerçekleştirilecektir."
          "errors": []
          "error_code": null
          "data": null
      }
      ```

      ```csharp .NET theme={null}
      {
        "Status": true,
        "Message": "İade talebi başarıyla oluşturuldu. Güvenlik incelemesi tamamlandıktan sonra iade işlemi gerçekleştirilecektir.",
        "ErrorCode": null,
        "Data": null
      }
      ```
    </CodeGroup>

    <Note>
      Bu uç nokta yalnızca secret key ile alınan access token üzerinden çağrılır.
      Secret key sadece arka uçta kullanılmalı ve asla istemci tarafında açıkta olmamalıdır.
    </Note>
  </Panel>
</div>