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

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# İadeler ve İtirazlar

> İade yapın, itirazlara kanıtla yanıt verin ve ters ibraz olaylarını dinleyin.

Bir ödeme gerçekleştikten sonra iki şey olabilir. **İadeler**, sizin (veya destek ekibinizin) bilerek yaptığı geri ödemelerdir. **İtirazlar**, alıcının bankasına başvurarak açtığı ters ibrazlardır. Bir itirazın nasıl sonuçlanacağını her zaman kontrol edemezsiniz, ancak kanıtla yanıt verebilirsiniz.

> [!TIP]
>
> Durum değişikliklerini yoklama yapmadan eşleştirebilmek için `refund.created`, `refund.updated`, `dispute.created`, `dispute.updated` ve `dispute_alert.created` olaylarına yönelik [webhook'lara](https://docs.whop.com/tr/developer/guides/webhooks.md) abone olun.

## İadeler

İadeler, başarılı bir ödemeyi geri alır. Whop bunları orijinal ödeme işlemcisi üzerinden işler. İlgili üyelik durumu otomatik olarak güncellenir.

### Bir iade yapın

İadeleri doğrudan refunds kaynağında değil, bir ödeme için oluşturun. `payments.refund({ id })` çağırın. Tam iade için `partial_amount` değerini atlayın, kısmi iade için ise iletin.

```typescript TypeScript theme={null}
import { WhopClient } from "@whop/sdk";

const client = new WhopClient({ token: process.env.WHOP_API_KEY });

// Full refund
const fullRefund = await client.payments.refund({ id: "pay_xxxxxxxxxxxxx" });

// Partial refund
const partialRefund = await client.payments.refund({
  id: "pay_xxxxxxxxxxxxx",
  partial_amount: 5.0, // in payment currency, e.g. 5 USD
});
```

```python Python theme={null}
import os
from whop_sdk import Whop

client = Whop(token=os.environ["WHOP_API_KEY"])

# Full refund
full_refund = client.payments.refund("pay_xxxxxxxxxxxxx")

# Partial refund
partial_refund = client.payments.refund(
    "pay_xxxxxxxxxxxxx",
    partial_amount=5.0,
)
```

```ruby Ruby theme={null}
require "whop_sdk"

client = Whop_sdk::Client.new(token: ENV.fetch("WHOP_API_KEY"))

# Full refund
full_refund = client.payments.refund(id: "pay_xxxxxxxxxxxxx")

# Partial refund
partial_refund = client.payments.refund(
  id: "pay_xxxxxxxxxxxxx",
  partial_amount: 5.0,
)
```

```rust Rust theme={null}
use whop_sdk::prelude::*;

let config = ClientConfig {
    token: Some(std::env::var("WHOP_API_KEY").unwrap()),
    ..Default::default()
};
let client = Whop::new(config).expect("Failed to build client");

// Full refund
let full_refund = client
    .payments
    .refund(&"pay_xxxxxxxxxxxxx".to_string(), &RefundPaymentsRequest::default(), None)
    .await?;

// Partial refund
let partial_refund = client
    .payments
    .refund(
        &"pay_xxxxxxxxxxxxx".to_string(),
        &RefundPaymentsRequest {
            partial_amount: Some(5.0), // in payment currency, e.g. 5 USD
        },
        None,
    )
    .await?;
```

```go Go theme={null}
import (
    "context"
    "log"
    "os"

    whopsdk "github.com/whopio/whopsdk-go/v2"
    "github.com/whopio/whopsdk-go/v2/client"
    "github.com/whopio/whopsdk-go/v2/option"
)

client := client.NewWhop(option.WithToken(os.Getenv("WHOP_API_KEY")))

// Full refund
_, err := client.Payments.Refund(context.TODO(), &whopsdk.RefundPaymentsRequest{
    ID: "pay_xxxxxxxxxxxxx",
})
if err != nil {
    log.Fatal(err)
}

// Partial refund
_, err = client.Payments.Refund(context.TODO(), &whopsdk.RefundPaymentsRequest{
    ID:            "pay_xxxxxxxxxxxxx",
    PartialAmount: whopsdk.Float64(5.0), // in payment currency, e.g. 5 USD
})
if err != nil {
    log.Fatal(err)
}
```

Yanıt, güncellenmiş `Payment` nesnesidir. `refunded_amount` alanı, iade edilen kümülatif toplamı yansıtır. Bir ödeme için tam tutarına kadar `refund` çağrısını birden çok kez yapabilirsiniz.

> [!NOTE]
>
> Gerekli izin: `payment:manage`. Uygulamanızı yayınlamadan önce bunu [İzinler kılavuzundan](https://docs.whop.com/tr/developer/guides/permissions.md) ekleyin.

### İadeleri inceleyin

İadeleri sonradan sorgulamanız gerekirse, bunların kendi kaynakları vardır.

```typescript TypeScript theme={null}
const refund = await client.refunds.retrieve({ id: "ref_xxxxxxxxxxxxx" });

const refunds = await client.refunds.list({
  account_id: "biz_xxxxxxxxxxxxx",
});

for await (const item of refunds) {
  console.log(item);
}
```

```python Python theme={null}
refund = client.refunds.retrieve("ref_xxxxxxxxxxxxx")

for item in client.refunds.list(account_id="biz_xxxxxxxxxxxxx"):
    print(item)
```

```ruby Ruby theme={null}
refund = client.refunds.retrieve(id: "ref_xxxxxxxxxxxxx")

client.refunds.list(account_id: "biz_xxxxxxxxxxxxx").each do |item|
  puts item
end
```

```rust Rust theme={null}
let refund = client
    .refunds
    .retrieve(&"ref_xxxxxxxxxxxxx".to_string(), None)
    .await?;

let refunds = client
    .refunds
    .list(
        &RefundsListQueryRequest {
            account_id: Some("biz_xxxxxxxxxxxxx".to_string()),
            ..Default::default()
        },
        None,
    )
    .await?;

for item in refunds.data {
    println!("{item:?}");
}
```

```go Go theme={null}
refund, err := client.Refunds.Retrieve(context.TODO(), &whopsdk.RetrieveRefundsRequest{
    ID: "ref_xxxxxxxxxxxxx",
})
if err != nil {
    log.Fatal(err)
}
fmt.Println(refund)

page, err := client.Refunds.List(context.TODO(), &whopsdk.ListRefundsRequest{
    AccountID: whopsdk.String("biz_xxxxxxxxxxxxx"),
})
if err != nil {
    log.Fatal(err)
}

iter := page.Iterator()
for iter.Next(context.TODO()) {
    fmt.Println(iter.Current())
}
if err := iter.Err(); err != nil {
    log.Fatal(err)
}
```

## İtirazlar

Bir itiraz (ters ibraz), alıcının bankası bir ödemeye itiraz ettiğinde açılır. Banka karar vermeden önce kanıtla yanıt vermek için belirli bir süreniz vardır. Whop itirazı size iletir, siz kanıt gönderirsiniz, banka karar verir ve itiraz kapanır.

### Gelen itirazları takip edin

Abone olunacak üç olay:

| Olay | Anlamı |
| - | - |
| [`dispute_alert.created`](https://docs.whop.com/tr/api-reference/dispute-alerts/dispute-alert-created) | Resmî bir itirazdan önceki itiraz uyarısı. Bazı işlemciler önceden haber verir. Her uyarı itiraza dönüşmez. |
| [`dispute.created`](https://docs.whop.com/tr/api-reference/disputes/dispute-created) | Resmî itiraz açıldı. Yanıt süresi başlar. |
| [`dispute.updated`](https://docs.whop.com/tr/api-reference/disputes/dispute-updated) | Durum değişiklikleri (ör. `needs_response` durumundan `under_review` durumuna, ardından `won` veya `lost`). |

### Listeleyin ve alın

```typescript TypeScript theme={null}
const disputes = await client.disputes.list({
  account_id: "biz_xxxxxxxxxxxxx",
});

for await (const item of disputes) {
  console.log(item);
}

const dispute = await client.disputes.retrieve({ id: "dspt_xxxxxxxxxxxxx" });
```

```python Python theme={null}
for item in client.disputes.list(account_id="biz_xxxxxxxxxxxxx"):
    print(item)

dispute = client.disputes.retrieve("dspt_xxxxxxxxxxxxx")
```

```ruby Ruby theme={null}
client.disputes.list(account_id: "biz_xxxxxxxxxxxxx").each do |item|
  puts item
end

dispute = client.disputes.retrieve(id: "dspt_xxxxxxxxxxxxx")
```

```rust Rust theme={null}
let disputes = client
    .disputes
    .list(
        &DisputesListQueryRequest {
            account_id: Some("biz_xxxxxxxxxxxxx".to_string()),
            ..Default::default()
        },
        None,
    )
    .await?;

for item in disputes.data {
    println!("{item:?}");
}

let dispute = client
    .disputes
    .retrieve(&"dspt_xxxxxxxxxxxxx".to_string(), None)
    .await?;
```

```go Go theme={null}
page, err := client.Disputes.List(context.TODO(), &whopsdk.ListDisputesRequest{
    AccountID: whopsdk.String("biz_xxxxxxxxxxxxx"),
})
if err != nil {
    log.Fatal(err)
}

iter := page.Iterator()
for iter.Next(context.TODO()) {
    fmt.Println(iter.Current())
}
if err := iter.Err(); err != nil {
    log.Fatal(err)
}

dispute, err := client.Disputes.Retrieve(context.TODO(), &whopsdk.RetrieveDisputesRequest{
    ID: "dspt_xxxxxxxxxxxxx",
})
if err != nil {
    log.Fatal(err)
}
fmt.Println(dispute)
```

### Kanıtla yanıt verin

İtirazlara iki adımda yanıt verilir: kanıtınızı `disputes.update` ile hazırlayın, ardından `disputes.submit` ile gönderin. Güncelleme idempotent'tir. Göndermeden önce alanları istediğiniz kadar düzenleyebilirsiniz.

```typescript TypeScript theme={null}
// Stage evidence (call as many times as needed)
await client.disputes.update({
  id: "dspt_xxxxxxxxxxxxx",
  evidence: {
    customer_name: "Jane Doe",
    customer_email_address: "jane@example.com",
    product_description: "Annual subscription to Acme Pro, purchased 2026-01-15.",
    service_date: "2026-01-15",
    refund_policy_disclosure: "Customer agreed to no-refunds policy at checkout.",
    notes: "Customer used the product 47 times across 8 sessions before disputing.",
  },
});

// Submit evidence to the processor. After this, you can no longer edit.
await client.disputes.submit({ id: "dspt_xxxxxxxxxxxxx" });
```

```python Python theme={null}
client.disputes.update(
    "dspt_xxxxxxxxxxxxx",
    evidence={
        "customer_name": "Jane Doe",
        "customer_email_address": "jane@example.com",
        "product_description": "Annual subscription to Acme Pro, purchased 2026-01-15.",
        "service_date": "2026-01-15",
        "refund_policy_disclosure": "Customer agreed to no-refunds policy at checkout.",
        "notes": "Customer used the product 47 times across 8 sessions before disputing.",
    },
)

client.disputes.submit("dspt_xxxxxxxxxxxxx")
```

```ruby Ruby theme={null}
# Stage evidence (call as many times as needed)
client.disputes.update(
  id: "dspt_xxxxxxxxxxxxx",
  evidence: {
    customer_name: "Jane Doe",
    customer_email_address: "jane@example.com",
    product_description: "Annual subscription to Acme Pro, purchased 2026-01-15.",
    service_date: "2026-01-15",
    refund_policy_disclosure: "Customer agreed to no-refunds policy at checkout.",
    notes: "Customer used the product 47 times across 8 sessions before disputing.",
  },
)

# Submit evidence to the processor. After this, you can no longer edit.
client.disputes.submit(id: "dspt_xxxxxxxxxxxxx")
```

```rust Rust theme={null}
// Stage evidence (call as many times as needed)
client
    .disputes
    .update(
        &"dspt_xxxxxxxxxxxxx".to_string(),
        &UpdateDisputesRequest {
            evidence: Some(DisputesUpdateDisputesRequestEvidence {
                customer_name: Some("Jane Doe".to_string()),
                customer_email_address: Some("jane@example.com".to_string()),
                product_description: Some(
                    "Annual subscription to Acme Pro, purchased 2026-01-15.".to_string(),
                ),
                service_date: Some("2026-01-15".to_string()),
                refund_policy_disclosure: Some(
                    "Customer agreed to no-refunds policy at checkout.".to_string(),
                ),
                notes: Some(
                    "Customer used the product 47 times across 8 sessions before disputing.".to_string(),
                ),
                ..Default::default()
            }),
        },
        None,
    )
    .await?;

// Submit evidence to the processor. After this, you can no longer edit.
client
    .disputes
    .submit(&"dspt_xxxxxxxxxxxxx".to_string(), None)
    .await?;
```

```go Go theme={null}
// Stage evidence (call as many times as needed)
_, err := client.Disputes.Update(context.TODO(), &whopsdk.UpdateDisputesRequest{
    ID: "dspt_xxxxxxxxxxxxx",
    Evidence: &whopsdk.UpdateDisputesRequestEvidence{
        CustomerName:           whopsdk.String("Jane Doe"),
        CustomerEmailAddress:   whopsdk.String("jane@example.com"),
        ProductDescription:     whopsdk.String("Annual subscription to Acme Pro, purchased 2026-01-15."),
        ServiceDate:            whopsdk.String("2026-01-15"),
        RefundPolicyDisclosure: whopsdk.String("Customer agreed to no-refunds policy at checkout."),
        Notes:                  whopsdk.String("Customer used the product 47 times across 8 sessions before disputing."),
    },
})
if err != nil {
    log.Fatal(err)
}

// Submit evidence to the processor. After this, you can no longer edit.
if _, err := client.Disputes.Submit(context.TODO(), &whopsdk.SubmitDisputesRequest{
    ID: "dspt_xxxxxxxxxxxxx",
}); err != nil {
    log.Fatal(err)
}
```

### Kanıt alanları

Her alan isteğe bağlıdır, ancak ne kadar çok bilgi sağlarsanız yanıt o kadar güçlü olur. Yaygın olanlar:

| Alan | İçine ne yazılmalı |
| - | - |
| `customer_name` / `customer_email_address` | Kayıtlarınızdaki tanımlayıcı bilgiler |
| `product_description` | Müşterinin ne satın aldığı, sade bir dille |
| `service_date` | Hizmeti ne zaman sunduğunuz (Uluslararası Standardizasyon Örgütü (ISO) 8601) |
| `billing_address` | Ödeme sırasında kullanılan adres |
| `customer_communication_attachment` | Müşterinin etkileşimde bulunduğunu gösteren e-posta veya sohbet yazışmaları |
| `cancellation_policy_attachment` / `cancellation_policy_disclosure` | Politikanız ve müşterinin bunu kabul ettiğinin kanıtı |
| `refund_policy_attachment` / `refund_policy_disclosure` | Aynısı, iadeler için |
| `refund_refusal_explanation` | Neden iade yapmadığınız (ör. iade süresi dışında kullanım) |
| `access_activity_log` | Müşterinin ürünü kullandığını kanıtlayan giriş veya kullanım kayıtları |
| `uncategorized_attachment` | İlgili diğer her şey |

Ek alanları, yüklenmiş bir dosyayı `{ id: file.id }` olarak alır. Önce [Files API](https://docs.whop.com/tr/developer/guides/upload-files.md) üzerinden yükleyin.

### İtiraz durumları

İtiraz bir durum makinesi içinde ilerler. İki aşama vardır: erken uyarı aşaması (`warning_` önekli, `dispute_alert.created` ile bildirilen durumlar) ve resmî itiraz aşaması. SDK'nın döndürebileceği tüm durumlar:

| Durum | Aşama | Anlamı |
| - | - | - |
| `warning_needs_response` | Uyarı | Bir itiraz uyarısı açık. Tırmanmadan önce bir iade veya yanıtla önüne geçebilirsiniz. |
| `warning_under_review` | Uyarı | Uyarıya yanıt verdiniz ve işlemci tırmandırıp tırmandırmayacağına karar veriyor. |
| `warning_closed` | Uyarı | Uyarı, resmî bir itiraza dönüşmeden çözüldü. |
| `needs_response` | İtiraz | Resmî itiraz açık. Yanıt süresi kapanmadan önce kanıt gönderin. |
| `under_review` | İtiraz | Kanıt gönderdiniz ve işlemci karar veriyor. |
| `won` | İtiraz | Para sizde kalır. |
| `lost` | İtiraz | Para alıcıya geri döner. Whop orijinal ödemeyi geri alır. |
| `prevented` | İtiraz | Müşteriye herhangi bir karardan önce iade yapıldı. `lost` gibi sonuçlanır. |

> [!NOTE]
>
> Bir itiraz **kaybedildiğinde** Whop otomatik olarak bir Refund kaydı oluşturmaz ve siz de kendiniz oluşturamazsınız. `payments.refund`, itiraz edilmiş bir ödemeye yönelik çağrıları `This payment has been disputed. Therefore, it cannot be refunded.` mesajıyla reddeder. Kaybedilen itirazı doğruluk kaynağı olarak takip edin ve bir `refund.created` olayı beklemeyin.

## İzinler

| İşlem | Gerekli izin |
| - | - |
| İade oluşturma | `payment:manage` |
| İadeleri alma / listeleme | `payment:basic:read` |
| İtirazları alma / listeleme | `payment:dispute:read` |
| Kanıtı güncelleme veya gönderme | `payment:dispute` |

Bunları [İzinler kılavuzundan](https://docs.whop.com/tr/developer/guides/permissions.md) ekleyin.

## Sonraki adımlar

> [card] [Ödeme kabul edin](https://docs.whop.com/tr/developer/guides/accept-payments.md)
>
> Daha sonra iade edeceğiniz veya savunacağınız ödemeleri oluşturan akış.

> [card] [Webhook'ları dinleyin](https://docs.whop.com/tr/developer/guides/webhooks.md)
>
> İade ve itiraz olaylarına sunucu tarafında tepki verin.

> [card] [Dosya yükleyin](https://docs.whop.com/tr/developer/guides/upload-files.md)
>
> İtiraz yanıtları için kanıt eklerini yükleyin.

> [card] [Disputes API referansı](https://docs.whop.com/tr/api-reference/disputes/dispute)
>
> Kaynağın tamamı: alanlar, durumlar ve her uç nokta.


## Related topics

- [Tercih Edilen Mutabakat Para Birimi](https://docs.whop.com/tr/developer/payouts/preferred-settlement-currency.md)
- [İstatistikler API Referansı](https://docs.whop.com/tr/api-reference/stats/stats.md)
- [Dolandırıcılığı yönetin](https://docs.whop.com/tr/developer/guides/manage-fraud.md)
