> ## 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.

# İtirazlar API'si

> İtiraz, bir müşterinin bankası aracılığıyla bir ödemeye karşı başlattığı ters ibraz veya ters ibraza dönüşebilecek bir sorgulamadır.

İtiraz edilen ödemeyi, yanıt verme son tarihini, kanıtlarınızı ve ödeme işlemcisi karar verdiğinde sonucu içerir.

İtirazlar API'sini itirazları listelemek, bir itiraza hâlâ karşı çıkılabilirken kanıt paketini düzenleyip incelemeye göndermek veya karşı çıkmak istemediğiniz bir ters ibrazı kabul etmek için kullanın.

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [İtirazları Listele](https://docs.whop.com/tr/api-reference/disputes/list-disputes.md) | GET `/disputes` |
| [İtirazı Al](https://docs.whop.com/tr/api-reference/disputes/retrieve-dispute.md) | GET `/disputes/{id}` |
| [İtiraz Özetini Al](https://docs.whop.com/tr/api-reference/disputes/retrieve-dispute-summary.md) | GET `/disputes/summary` |
| [İtirazı Kabul Et](https://docs.whop.com/tr/api-reference/disputes/accept-dispute.md) | POST `/disputes/{id}/accept` |
| [İtirazı Gönder](https://docs.whop.com/tr/api-reference/disputes/submit-dispute.md) | POST `/disputes/{id}/submit` |
| [İtiraz Kanıtı Yükle](https://docs.whop.com/tr/api-reference/disputes/upload-dispute-evidence.md) | POST `/disputes/{id}/upload_evidence` |
| [İtirazı Güncelle](https://docs.whop.com/tr/api-reference/disputes/update-dispute.md) | PATCH `/disputes/{id}` |

## Öznitelikler

**id** `string` *required*

`dspt_` önekli itiraz kimliği.

**acceptable** `boolean` *required*

İtirazın `POST /disputes/\{id} /accept` ile müşteri lehine kabul edilip edilemeyeceği. Yalnızca `evidence_due_at` tarihinden önce, hâlâ yanıt bekleyen ve ödeme işlemcisi itiraz kabulünü destekleyen bir ters ibraz için true'dur. Sorgulamalar hiçbir zaman kabul edilemez.

**account\_id** `string | null` *required*

İtirazın açıldığı `biz_` önekli hesap.

**amount** `number` *required*

`currency` biriminin tam birimleri cinsinden itiraz edilen tutar.

**buyer** `object` *required*

İtirazı açan müşteri.

> [accordion] Özellikler
>
> **email** `string | null` *required*
>
> Müşterinin e-posta adresi. `member:email:read` kapsamını gerektirir; bu kapsam olmadan `null`.
>
> **member\_id** `string | null` *required*
>
> Müşterinin hesaptaki `mem_` önekli üye kaydı.
>
> **name** `string | null` *required*
>
> Müşterinin görünen adı.
>
> **user\_id** `string | null` *required*
>
> Müşterinin `user_` önekli kullanıcı kimliği. Misafir ödemesi için `null`.
>
> **username** `string | null` *required*
>
> Müşterinin Whop kullanıcı adı.

**created\_at** `string` *required*

İtirazın açıldığı zaman, ISO 8601 zaman damgası olarak.

**currency** `string` *required*

İtiraz edilen tutarın üç harfli ISO para birimi kodu.

**evidence** `object` *required*

İtiraza karşı çıkmak için ödeme işlemcisine gönderilen kanıt paketi.

> [accordion] Özellikler
>
> **access\_activity\_log** `string | null` *required*
>
> Müşterinin ürüne erişim günlüğü; örneğin oturum açma veya indirme etkinliği.
>
> **billing\_address** `string | null` *required*
>
> Müşterinin ödeme sırasında sağladığı fatura adresi.
>
> **cancellation\_policy\_attachment** `object | null` *required*
>
> İptal politikası belgesi. Varsayılan olarak hesabın iptal politikası, ardından hizmet şartları, ardından iade politikası, ardından Whop'un platform politikası kullanılır.
>
> > [accordion] Özellikler
> >
> > **id** `string | null` *required*
> >
> > Ekin kimliği. Yüklenmiş bir dosya olmayan, Whop tarafından barındırılan bir politika için `null`.
> >
> > **content\_type** `string | null` *required*
> >
> > Yüklenen dosyanın MIME türü.
> >
> > **filename** `string | null` *required*
> >
> > Yüklenen dosyanın adı.
> >
> > **platform** `boolean` *required*
> >
> > Satıcı hiçbir şey yüklemediği için yerine geçen, Whop'un kendi barındırdığı politika olup olmadığı. Bir PATCH isteğinde geri göndermek hiçbir şeyi değiştirmez.
> >
> > **url** `string | null` *required*
> >
> > Eki indirmek için bir URL.
>
> **cancellation\_policy\_disclosure** `string | null` *required*
>
> İptal politikasının satın alma öncesinde müşteriye nasıl gösterildiği.
>
> **customer\_communication\_attachment** `object | null` *required*
>
> Müşteriyle yazışmalar veya ürünü kullandıklarına dair kanıt.
>
> > [accordion] Özellikler
> >
> > **id** `string | null` *required*
> >
> > Ekin kimliği. Yüklenmiş bir dosya olmayan, Whop tarafından barındırılan bir politika için `null`.
> >
> > **content\_type** `string | null` *required*
> >
> > Yüklenen dosyanın MIME türü.
> >
> > **filename** `string | null` *required*
> >
> > Yüklenen dosyanın adı.
> >
> > **platform** `boolean` *required*
> >
> > Satıcı hiçbir şey yüklemediği için yerine geçen, Whop'un kendi barındırdığı politika olup olmadığı. Bir PATCH isteğinde geri göndermek hiçbir şeyi değiştirmez.
> >
> > **url** `string | null` *required*
> >
> > Eki indirmek için bir URL.
>
> **customer\_email\_address** `string | null` *required*
>
> Müşterinin ödeme sırasında kullandığı e-posta adresi.
>
> **customer\_name** `string | null` *required*
>
> Müşterinin ödeme sırasında verdiği ad.
>
> **documents** `object[]` *required*
>
> Dört sabit alanın ötesindeki ek kanıt belgeleri — `PATCH /disputes/\{id}` üzerinde `evidence.documents` ile ayarlanır. Her biri gönderilen pakete kendi `document_type` değeri altında eklenir.
>
> > [accordion] Özellikler
> >
> > **id** `string` *required*
> >
> > `file_` önekli dosya kimliği.
> >
> > **blurhash** `string | null` *required*
> >
> > Bir resim veya video için BlurHash yer tutucusu. Kullanılamadığında veya moderasyon tarafından kaldırıldığında null.
> >
> > **content\_type** `string | null` *required*
> >
> > Yüklenen dosyanın MIME türü. Yüklemeler ödeme işlemcisinin kabul ettiği türlerle sınırlıdır ve tür olmadan reddedilir — asla null değildir.
> >
> > Kullanılabilir seçenekler: `application/pdf`, `application/json`, `image/jpeg`, `image/png`, `image/webp`
> >
> > **created\_at** `string` *required*
> >
> > Dosyanın oluşturulduğu zaman, ISO 8601 zaman damgası olarak.
> >
> > **document\_type** `string` *required*
> >
> > Bu belgenin neyi kanıtladığı. `return_policy`, `cancellation_policy` ve `terms_of_service` satıcının politika belgeleridir. Bir politika belgesi, bu itiraz için hesabın kopyasının yerini alır. `return_policy`, `cancellation_policy` ve `customer_communication` ayrıca eşleşen sabit kanıt alanının yerini alır. `shipping_policy` satıcının kargo koşullarıdır. `customer_communication` alıcıyla yapılan yazışmalardır; örneğin bir destek yazışması veya sohbet günlüğü. `product_image`, alıcının aldığı ürün veya hizmetin bir fotoğrafıdır. `physical_fulfillment`, fiziksel bir siparişin gönderildiğinin ve ulaştığının kanıtıdır. `digital_fulfillment`, alıcının dijital bir ürüne eriştiğinin kanıtıdır. `customer_order_history`, alıcının bu satıcıdan verdiği geçmiş siparişlerdir. `prior_transactions`, dolandırıcılık savunması için alıcının platform genelindeki ödeme geçmişidir. `customer_session`, IP adresi, cihaz parmak izi, AVS ve CVV sonuçları ile 3D Secure sonucu gibi ödeme verileridir. `subscription`, yenilemeler, iptal ve gönderilen hatırlatmalar gibi üyelik yaşam döngüsü kanıtıdır. `complete_evidence`, satıcının tüm yanıtını en fazla 19 sayfalık tek bir PDF olarak içerir ve tek belge olmalıdır. Whop, `complete_evidence` belgesini diğer tüm kanıt alanları, ekler ve belgeler yerine ödeme işlemcisine gönderir.
> >
> > Kullanılabilir seçenekler: `return_policy`, `shipping_policy`, `cancellation_policy`, `terms_of_service`, `physical_fulfillment`, `customer_order_history`, `product_image`, `prior_transactions`, `customer_session`, `digital_fulfillment`, `subscription`, `customer_communication`, `complete_evidence`
> >
> > **duration\_seconds** `number | null` *required*
> >
> > Saniye cinsinden ses veya video süresi. Kullanılamadığında veya moderasyon tarafından kaldırıldığında null.
> >
> > **filename** `string | null` *required*
> >
> > Uzantısı dahil orijinal dosya adı.
> >
> > **height** `integer | null` *required*
> >
> > Piksel cinsinden resim veya video yüksekliği. Kullanılamadığında veya moderasyon tarafından kaldırıldığında null.
> >
> > **multipart\_chunk\_size** `integer | null`
> >
> > Her parçanın (sonuncusu hariç) sahip olması gereken bayt boyutu. Yalnızca oluşturma sırasında ve yalnızca çok parçalı yüklemeler için bulunur.
> >
> > **multipart\_upload\_id** `string | null`
> >
> > `complete` çağrısına geri iletilen çok parçalı yükleme kimliği. Yalnızca oluşturma sırasında ve yalnızca çok parçalı yüklemeler için bulunur.
> >
> > **multipart\_upload\_urls** `object[] | null`
> >
> > Her parça için önceden imzalanmış URL. Yalnızca oluşturma sırasında ve yalnızca çok parçalı yüklemeler için bulunur.
> >
> > > [accordion] Özellikler
> > >
> > > **part\_number** `integer` *required*
> > >
> > > Bu parçanın çok parçalı yükleme içindeki 1 tabanlı dizini.
> > >
> > > **url** `string` *required*
> > >
> > > Bu parçanın baytlarının PUT ile gönderileceği önceden imzalanmış URL.
> >
> > **object** `string` *required*
> >
> > Bu nesnenin türü, her zaman `file`.
> >
> > **removed\_by\_moderation** `boolean` *required*
> >
> > Moderasyonun dosyayı kaldırıp kaldırmadığı. `true` olduğunda `url` yerine geçen bir resim sunar. `filename`, `size` ve `content_type` hâlâ orijinal dosyayı tanımlar.
> >
> > **size** `integer | null` *required*
> >
> > Bayt cinsinden dosya boyutu. Yükleme tamamlanana kadar `null`.
> >
> > **upload\_headers** `object`
> >
> > Yükleme PUT isteğiyle gönderilecek başlıklar. Yalnızca oluşturma sırasında bulunur.
> >
> > **upload\_status** `string` *required*
> >
> > Dosyanın yükleme yaşam döngüsünde nerede olduğu.
> >
> > Kullanılabilir seçenekler: `pending`, `processing`, `ready`, `failed`
> >
> > **upload\_url** `string | null`
> >
> > Dosyanın baytlarının PUT ile gönderileceği önceden imzalanmış URL. Yalnızca oluşturma sırasında ve yalnızca tek parçalı yüklemeler için bulunur.
> >
> > **url** `string | null` *required*
> >
> > Dosyayı indirmek için bir URL. Herkese açık dosyalar kalıcı bir CDN URL'si, özel dosyalar ise süresi dolan imzalı bir URL alır. Yükleme tamamlanana kadar `null`. Moderasyon dosyayı kaldırdığında, yerine geçen bir resim URL'si.
> >
> > **visibility** `string` *required*
> >
> > `public` dosyalar imzasız bir CDN URL'sinden sunulur. `private` dosyalar süresi dolan imzalı bir URL'den sunulur.
> >
> > Kullanılabilir seçenekler: `public`, `private`
> >
> > **waveform\_url** `string | null` *required*
> >
> > Ses dalga formu URL'si. Kullanılamadığında veya moderasyon tarafından kaldırıldığında null.
> >
> > **width** `integer | null` *required*
> >
> > Piksel cinsinden resim veya video genişliği. Kullanılamadığında veya moderasyon tarafından kaldırıldığında null.
>
> **notes** `string | null` *required*
>
> İtirazı inceleyen ödeme işlemcisi için ek bağlam.
>
> **product\_description** `string | null` *required*
>
> Müşterinin satın aldığı şey, satıcının kendi ifadesiyle.
>
> **refund\_policy\_attachment** `object | null` *required*
>
> İade politikası belgesi. Varsayılan olarak hesabın iade politikası, ardından hizmet şartları, ardından Whop'un platform politikası kullanılır.
>
> > [accordion] Özellikler
> >
> > **id** `string | null` *required*
> >
> > Ekin kimliği. Yüklenmiş bir dosya olmayan, Whop tarafından barındırılan bir politika için `null`.
> >
> > **content\_type** `string | null` *required*
> >
> > Yüklenen dosyanın MIME türü.
> >
> > **filename** `string | null` *required*
> >
> > Yüklenen dosyanın adı.
> >
> > **platform** `boolean` *required*
> >
> > Satıcı hiçbir şey yüklemediği için yerine geçen, Whop'un kendi barındırdığı politika olup olmadığı. Bir PATCH isteğinde geri göndermek hiçbir şeyi değiştirmez.
> >
> > **url** `string | null` *required*
> >
> > Eki indirmek için bir URL.
>
> **refund\_policy\_disclosure** `string | null` *required*
>
> İade politikasının satın alma öncesinde müşteriye nasıl gösterildiği.
>
> **refund\_refusal\_explanation** `string | null` *required*
>
> Bir iade talep edilip reddedildiğinde, iadenin neden reddedildiği.
>
> **service\_date** `string | null` *required*
>
> Ürünün veya hizmetin teslim edildiği zaman.
>
> **uncategorized\_attachment** `object | null` *required*
>
> Diğer kategorilere uymayan destekleyici kanıtlar.
>
> > [accordion] Özellikler
> >
> > **id** `string | null` *required*
> >
> > Ekin kimliği. Yüklenmiş bir dosya olmayan, Whop tarafından barındırılan bir politika için `null`.
> >
> > **content\_type** `string | null` *required*
> >
> > Yüklenen dosyanın MIME türü.
> >
> > **filename** `string | null` *required*
> >
> > Yüklenen dosyanın adı.
> >
> > **platform** `boolean` *required*
> >
> > Satıcı hiçbir şey yüklemediği için yerine geçen, Whop'un kendi barındırdığı politika olup olmadığı. Bir PATCH isteğinde geri göndermek hiçbir şeyi değiştirmez.
> >
> > **url** `string | null` *required*
> >
> > Eki indirmek için bir URL.

**evidence\_due\_at** `string | null` *required*

Kanıt göndermek için son tarih, ISO 8601 zaman damgası olarak. Ağ itirazı kanıt aşaması olmadan zaten otomatik olarak çözdüğünde (Visa RDR) veya ödeme işlemcisi bu itiraz için bir son tarih bildirmediğinde `null`.

**evidence\_editable** `boolean` *required*

`evidence` değerinin hâlâ değiştirilip gönderilip gönderilemeyeceği.

**evidence\_locked\_reason** `string | null` *required*

Kanıtın neden artık düzenlenemediği. `evidence_editable` true iken `null`.

Kullanılabilir seçenekler: `submitted`, `response_window_closed`, `not_contestable`

**evidence\_submitted\_at** `string | null` *required*

Kanıtın ödeme işlemcisine gönderildiği zaman, ISO 8601 zaman damgası olarak.

**fee** `object | null` *required*

Hesaptan alınan itiraz ücreti, tahsil edildiği para birimi cinsinden. `fee_charged` false olduğunda `null`.

> [accordion] Özellikler
>
> **amount** `string` *required*
>
> Ana birim cinsinden tutar, tam bir ondalık dize olarak. Örneğin `"10.00"` on dolardır. Aktarım sırasında hiçbir kayan nokta yuvarlaması olmaması için dize olarak verilir.
>
> **currency** `string` *required*
>
> Üç harfli, küçük harfli ISO 4217 para birimi kodu.
>
> **decimals** `integer` *required*
>
> Tutarın kaç ondalık basamak taşıdığı. Bu, ücretin kendisinin işlendiği hassasiyettir.
>
> **display\_decimals** `integer` *required*
>
> Kaç ondalık basamağın GÖSTERİLECEĞİ. Genellikle `decimals` ile aynıdır, ancak bilinçli olarak her zaman değil: COP centavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu nedenle `2` ve `0` olur. Sayıyı kendi yerel ayarınızda bunu kullanarak biçimlendirin.

**fee\_charged** `boolean` *required*

Whop'un bunun için hesaptan bir itiraz ücreti alıp almadığı. Ödeme itiraz açılmadan önce tamamen iade edildiğinde, bir Visa RDR çözümlemesi için ve bir sorgulama için `false`.

**inquiry** `boolean` *required*

Bunun resmi bir ters ibraz yerine itiraz öncesi bir sorgulama olup olmadığı. Sorgulamalar aynı yaşam döngüsünü izler ancak tırmanmadıkça para hareketi yaratmaz.

**issuer\_comments** `object[]` *required*

Kartı çıkaran bankanın itirazı açarken söyledikleri. Yalnızca kartı çıkaran banka bunları sağladığında doldurulur ve alındıkları sırayla listelenir.

> [accordion] Özellikler
>
> **received\_at** `string | null` *required*
>
> Yorumun alındığı zaman, ISO 8601 zaman damgası olarak.
>
> **text** `string` *required*
>
> Kartı çıkaran bankanın yazdığı, alındığı şekliyle.

**line\_items** `object[]` *required*

İtiraz edilen ödemenin ücretlendirdiği her şey, satın alma sırasına göre. `product_id` ve `variant_id` bunların ilkini belirtir; bir sepetin sonraki öğeleri yalnızca burada görünür. Öğeler kaydedilmeye başlanmadan önce yapılan bir ödeme, varyantının ima ettiği tek öğeyi listeler. Ödeme bir varyanta bağlı değilse boştur.

> [accordion] Özellikler
>
> **id** `string | null` *required*
>
> `li_` önekli satır öğesi kimliği. Ödeme öğe anlık görüntülerinden önceyse ve öğe ödemenin varyantından okunuyorsa null.
>
> **label** `string | null` *required*
>
> Öğenin ödeme sırasında gösterilen adı (ürün başlığı, yoksa varyant başlığı).
>
> **product\_id** `string | null` *required*
>
> Varyantın ait olduğu `prod_` önekli ürün. Öğe anlık görüntülerinden önceki bir ödemede bu, varyantın ürününe geri döner; bu nedenle üst öğenin kendi `product_id` değeri null olduğu yerde ayarlanmış olabilir. Ürünü olmayan bir varyant için null.
>
> **product\_title** `string | null` *required*
>
> Ürünün güncel başlığı veya öğenin ürünü yoksa `null`.
>
> **quantity** `number` *required*
>
> Kaç adet satın alındığı.
>
> **sku** `string | null` *required*
>
> Varyantın stok tutma birimi; satıcı tarafından ayarlanan serbest metin (ör. `TSHIRT-LARGE-BLUE`). Faturalandırma nedeni SKU sonekleri etkin olan hesaplar, ücretin neden alındığını belirten bir ekle birlikte alır: ilk abonelik ücreti için `-S`, yenileme için `-R`, tek seferlik satın alma için `-C`, ödemenin kendi meta verileri `upsell: true` içerdiğinde `-U`, hiçbir ücret alınmadığında `-F`. Diğer faturalandırma nedenleri yalın SKU'yu taşır. Varyantın SKU'su yoksa veya silinmişse `null`.
>
> **subtotal** `object | null` *required*
>
> Bu öğenin tam miktarı için indirimler, vergi ve ücretlerden önce, satın alma para birimi cinsinden kaydedilen tutar. Hiçbir öğe tutarı kaydedilmediyse `null` döndürür.
>
> > [accordion] Özellikler
> >
> > **amount** `string` *required*
> >
> > Ana birim cinsinden tutar, tam bir ondalık dize olarak. Örneğin `"10.00"` on dolardır. Aktarım sırasında hiçbir kayan nokta yuvarlaması olmaması için dize olarak verilir.
> >
> > **currency** `string` *required*
> >
> > Üç harfli, küçük harfli ISO 4217 para birimi kodu.
> >
> > **decimals** `integer` *required*
> >
> > Tutarın kaç ondalık basamak taşıdığı. Bu, ücretin kendisinin işlendiği hassasiyettir.
> >
> > **display\_decimals** `integer` *required*
> >
> > Kaç ondalık basamağın GÖSTERİLECEĞİ. Genellikle `decimals` ile aynıdır, ancak bilinçli olarak her zaman değil: COP centavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu nedenle `2` ve `0` olur. Sayıyı kendi yerel ayarınızda bunu kullanarak biçimlendirin.
>
> **variant\_id** `string | null` *required*
>
> Satın alınan `plan_` önekli varyant. Varyant o zamandan beri silinmişse null.
>
> **variant\_title** `string | null` *required*
>
> Varyantın güncel başlığı veya varyant silinmişse ya da başlığı yoksa `null`.

**payment** `object` *required*

İtiraz edilen ödeme.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> `pay_` önekli ödeme kimliği.
>
> **amount** `number | null` *required*
>
> Müşteriden alınan ücret, ödemenin para biriminin tam birimleri cinsinden.
>
> **card\_brand** `string | null` *required*
>
> Müşteri kartla ödeme yaptığında kart markası.
>
> **card\_last4** `string | null` *required*
>
> Müşteri kartla ödeme yaptığında kartın son dört hanesi.
>
> **created\_at** `string` *required*
>
> Ödemenin yapıldığı zaman, ISO 8601 zaman damgası olarak.
>
> **currency** `string | null` *required*
>
> Ödemenin üç harfli ISO para birimi kodu. Ödeme işlemcisi başka bir para biriminde mutabakat yaptığında itirazın para biriminden farklı olabilir.
>
> **payment\_instrument** `object | null` *required*
>
> Bu ödemenin yapıldığı araç, görüntüleme için biçimlendirilmiş: yöntem türü, alıcıya yönelik bir ad, standart simge seti ve kartsa hesabın kart için kullandığı ağ işlem kimliği dahil kart bilgileri. Ödeme hiçbir yöntem belirtmiyorsa null.
>
> > [accordion] Özellikler
> >
> > **card** `object | null` *required*
> >
> > Yalnızca Kart, Apple Pay ve Google Pay ödemeleri: kartın ağı, son dört hanesi, kartı çıkaran kuruluş tanımlama numarası, son kullanma tarihi ve ağ işlem kimliği.
> >
> > > [accordion] Özellikler
> > >
> > > **brand** `string | null` *required*
> > >
> > > `card.networks` girişleri ve kayıtlı kart ödeme yöntemleriyle eşleşen ağ tanımlayıcısı (`visa`, `amex`, …). Kasa ağı kaydetmediyse null.
> > >
> > > **exp\_month** `number | null` *required*
> > >
> > > Kartın son kullanma ayı, 1 ile 12 arası. Kasa bunu kaydetmediyse null.
> > >
> > > **exp\_year** `number | null` *required*
> > >
> > > Kartın dört haneli son kullanma yılı. Kasa bunu kaydetmediyse null.
> > >
> > > **issuer\_identification\_number** `string | null` *required*
> > >
> > > BIN olarak da adlandırılan kartı çıkaran kuruluş tanımlama numarası: kartı çıkaran bankayı tanımlayan, kartın ilk altı veya sekiz hanesi. Ödeme işlemcisi bunu bildirmediyse null.
> > >
> > > **last4** `string | null` *required*
> > >
> > > Yakalandığında kartın son dört hanesi.
> > >
> > > **network\_transaction\_id** `string | null` *required*
> > >
> > > Bu hesabın kart için kullandığı ağ işlem kimliği. Whop'ta varsa, bu hesabın kart üzerindeki ilk müşterinin hazır bulunduğu ücretinden veya doğrulamasından gelen kendi kimliğidir. Aksi takdirde bu kart için daha önceki bir ağ işlem kimliğidir; başka bir hesabın işleminden gelebilir veya kartla birlikte getirilmiş olabilir. Bu kartın bu hesapta daha sonraki satıcı tarafından başlatılan bir ücretinde önceki işlem olarak buna atıfta bulunun. Bir tane olana kadar null. Bir ödeme ilk kaydedilirken gönderilen bir webhook `null` taşıyabilir; bu nedenle okumak için ödemeyi alın.
> >
> > **display\_name** `string` *required*
> >
> > Alıcıya yönelik araç adı — kart görünür olduğunda "Visa •••• 4242", aksi takdirde yöntemin kendi adı ("Klarna").
> >
> > **icons** `object` *required*
> >
> > Standart simge seti: her biri açık ve koyu renk düzenlerinde kare ve kart biçimleri.
> >
> > > [accordion] Özellikler
> > >
> > > **card** `object` *required*
> > >
> > > Kredi kartı oranlarındaki karo (48x30).
> > >
> > > > [accordion] Özellikler
> > > >
> > > > **dark** `object` *required*
> > > >
> > > > Koyu yüzeyler için renk düzeni.
> > > >
> > > > > [accordion] Özellikler
> > > > >
> > > > > **png\_1x** `string` *required*
> > > > >
> > > > > Biçimin doğal boyutunda raster yedek.
> > > > >
> > > > > **png\_2x** `string` *required*
> > > > >
> > > > > Çift yoğunlukta raster yedek.
> > > > >
> > > > > **png\_4x** `string` *required*
> > > > >
> > > > > Dört kat yoğunlukta raster yedek.
> > > > >
> > > > > **svg** `string` *required*
> > > > >
> > > > > Vektör dosyası. SVG'nin işlendiği her yerde bunu tercih edin.
> > > >
> > > > **light** `object` *required*
> > > >
> > > > Açık yüzeyler için renk düzeni.
> > > >
> > > > > [accordion] Özellikler
> > > > >
> > > > > **png\_1x** `string` *required*
> > > > >
> > > > > Biçimin doğal boyutunda raster yedek.
> > > > >
> > > > > **png\_2x** `string` *required*
> > > > >
> > > > > Çift yoğunlukta raster yedek.
> > > > >
> > > > > **png\_4x** `string` *required*
> > > > >
> > > > > Dört kat yoğunlukta raster yedek.
> > > > >
> > > > > **svg** `string` *required*
> > > > >
> > > > > Vektör dosyası. SVG'nin işlendiği her yerde bunu tercih edin.
> > >
> > > **square** `object` *required*
> > >
> > > Kare karo (32x32).
> > >
> > > > [accordion] Özellikler
> > > >
> > > > **dark** `object` *required*
> > > >
> > > > Koyu yüzeyler için renk düzeni.
> > > >
> > > > > [accordion] Özellikler
> > > > >
> > > > > **png\_1x** `string` *required*
> > > > >
> > > > > Biçimin doğal boyutunda raster yedek.
> > > > >
> > > > > **png\_2x** `string` *required*
> > > > >
> > > > > Çift yoğunlukta raster yedek.
> > > > >
> > > > > **png\_4x** `string` *required*
> > > > >
> > > > > Dört kat yoğunlukta raster yedek.
> > > > >
> > > > > **svg** `string` *required*
> > > > >
> > > > > Vektör dosyası. SVG'nin işlendiği her yerde bunu tercih edin.
> > > >
> > > > **light** `object` *required*
> > > >
> > > > Açık yüzeyler için renk düzeni.
> > > >
> > > > > [accordion] Özellikler
> > > > >
> > > > > **png\_1x** `string` *required*
> > > > >
> > > > > Biçimin doğal boyutunda raster yedek.
> > > > >
> > > > > **png\_2x** `string` *required*
> > > > >
> > > > > Çift yoğunlukta raster yedek.
> > > > >
> > > > > **png\_4x** `string` *required*
> > > > >
> > > > > Dört kat yoğunlukta raster yedek.
> > > > >
> > > > > **svg** `string` *required*
> > > > >
> > > > > Vektör dosyası. SVG'nin işlendiği her yerde bunu tercih edin.
> >
> > **installment\_count** `number | null` *required*
> >
> > Yalnızca taksitli yöntemler: ücretin kaç ödemeye bölündüğü. Metin değil veridir — etiketi istemci tarafında oluşturun ve çevirin.
> >
> > **payment\_method\_type** `string` *required*
> >
> > Ödeme yöntemi türü tanımlayıcısı, örneğin `card`, `klarna`, `apple_pay`.
>
> **payment\_method\_type** `string | null` *required*
>
> Müşterinin nasıl ödediği, örneğin `card` veya `paypal`.
>
> **payment\_processor** `string | null` *required*
>
> Kullanımdan kaldırıldı: artık doldurulmuyor. Her zaman `null`. KULLANIMDAN KALDIRILDI: Artık doldurulmuyor. Her zaman null.

**product\_id** `string | null` *required*

İtiraz edilen ödemenin ait olduğu `prod_` önekli ürün.

**reason** `string` *required*

Müşterinin itiraz etme nedeni olarak belirttiği şey, ödeme işlemcileri ve kart ağları genelinde normalleştirilmiş. `other`, Whop'un henüz kategorize etmediği bir ödeme işlemcisi nedenini kapsar.

Kullanılabilir seçenekler: `fraudulent`, `unrecognized`, `declined_authorization`, `product_not_received`, `product_unacceptable`, `subscription_canceled`, `credit_not_processed`, `duplicate`, `processing_error`, `documentation_request`, `bank_cannot_process`, `other`

**reason\_code** `string | null` *required*

Ham kart ağı veya ödeme işlemcisi neden kodu, örneğin `10.4`. Yalnızca bilgilendirme amaçlıdır — `reason` bundan türetilmez.

**status** `string` *required*

`needs_response` kanıt bekler (bir ödeme işlemcisi bir başvuruyu reddettikten sonra `submission_failure_reason` nedenini belirtir); `generating_response` kanıtı ödeme işlemcisindedir, henüz kabul edilmemiştir; `under_review` ödeme işlemcisindedir; `won`/`lost` kararlardır; `prevented`, `lost` gibi sonuçlanır. `warning_` durumları sorgulama kademeleridir. `evidence_due_at` geçtikten sonra açık bir itiraz `under_review` bildirir.

Kullanılabilir seçenekler: `needs_response`, `warning_needs_response`, `under_review`, `warning_under_review`, `generating_response`, `won`, `lost`, `prevented`, `warning_closed`

**submission\_failure\_reason** `string | null` *required*

İtiraz yeniden `needs_response` durumundayken, ödeme işlemcisinin son başvuruyu neden reddettiği, sade bir dille. Belirtilen sorunu düzeltin ve yeniden gönderin. Yalnızca alma işleminde: `dispute.updated`, `needs_response` durumuna geri dönüşü bildirir; ardından bunu buradan okuyun.

**updated\_at** `string` *required*

İtirazın son değiştirildiği zaman, ISO 8601 zaman damgası olarak.

**variant\_id** `string | null` *required*

İtiraz edilen ödemenin yapıldığı `plan_` önekli varyant.

```json Dispute theme={null}
{
	"id": "dspt_xxxxxxxxxxxxx",
	"acceptable": true,
	"account_id": "biz_xxxxxxxxxxxxxx",
	"amount": 49.99,
	"buyer": {
		"email": "alex@example.com",
		"member_id": "mem_xxxxxxxxxxxxx",
		"name": "Alex Rivera",
		"user_id": "user_xxxxxxxxxxxxx",
		"username": "alex"
	},
	"created_at": "2026-06-01T12:00:00Z",
	"currency": "usd",
	"evidence": {
		"access_activity_log": "2026-05-02 14:11 UTC signed in and opened the course; 2026-05-04 09:32 UTC downloaded lesson materials",
		"billing_address": "123 Main St, Austin, TX 78701, US",
		"cancellation_policy_attachment": null,
		"cancellation_policy_disclosure": "Shown on the checkout page beneath the pay button.",
		"customer_communication_attachment": {
			"id": "att_xxxxxxxxxxxxx",
			"content_type": "application/pdf",
			"filename": "support-thread.pdf",
			"platform": false,
			"url": "https://assets.whop.com/uploads/att_xxxxxxxxxxxxx/support-thread.pdf"
		},
		"customer_email_address": "alex@example.com",
		"customer_name": "Alex Rivera",
		"notes": "Customer accessed the product for four weeks before disputing.",
		"product_description": "Monthly membership to the Pickaxe trading community, including the full course library.",
		"refund_policy_attachment": {
			"id": null,
			"content_type": "application/pdf",
			"filename": "refund-policy.pdf",
			"platform": true,
			"url": "https://whop.com/policies/refund-policy.pdf"
		},
		"refund_policy_disclosure": "Linked in the order confirmation email and on the checkout page.",
		"refund_refusal_explanation": "Refund was refused because the membership had been used past the 7-day refund window.",
		"service_date": "2026-05-01",
		"uncategorized_attachment": null,
		"documents": [
			{
				"id": "file_xxxxxxxxxxxxxx",
				"object": "file",
				"document_type": "product_image",
				"filename": "before-and-after-coating.png",
				"content_type": "image/png",
				"size": 48213,
				"url": "https://cdn.whop.com/attachments/before-and-after-coating.png",
				"upload_status": "ready",
				"visibility": "private",
				"created_at": "2026-06-01T12:00:00Z",
				"width": null,
				"height": null,
				"blurhash": null,
				"duration_seconds": null,
				"waveform_url": null,
				"removed_by_moderation": false
			}
		]
	},
	"evidence_due_at": "2026-06-15T00:00:00Z",
	"evidence_editable": true,
	"evidence_locked_reason": null,
	"submission_failure_reason": null,
	"evidence_submitted_at": null,
	"fee": {
		"amount": "15.00",
		"currency": "usd",
		"decimals": 2,
		"display_decimals": 2
	},
	"fee_charged": true,
	"inquiry": false,
	"issuer_comments": [
		{
			"received_at": "2026-06-01T12:00:00Z",
			"text": "Cardholder states they did not authorize this transaction."
		}
	],
	"payment": {
		"id": "pay_xxxxxxxxxxxxx",
		"amount": 49.99,
		"card_brand": "visa",
		"card_last4": "4242",
		"created_at": "2026-05-01T09:30:00Z",
		"currency": "usd",
		"payment_method_type": "card",
		"payment_processor": null,
		"payment_instrument": {
			"payment_method_type": "card",
			"display_name": "Visa •••• 4242",
			"icons": {
				"square": {
					"light": {
						"svg": "https://content.whop.com/payment_methods/visa/square_light.svg",
						"png_1x": "https://content.whop.com/payment_methods/visa/square_light_32.png",
						"png_2x": "https://content.whop.com/payment_methods/visa/square_light_64.png",
						"png_4x": "https://content.whop.com/payment_methods/visa/square_light_128.png"
					},
					"dark": {
						"svg": "https://content.whop.com/payment_methods/visa/square_dark.svg",
						"png_1x": "https://content.whop.com/payment_methods/visa/square_dark_32.png",
						"png_2x": "https://content.whop.com/payment_methods/visa/square_dark_64.png",
						"png_4x": "https://content.whop.com/payment_methods/visa/square_dark_128.png"
					}
				},
				"card": {
					"light": {
						"svg": "https://content.whop.com/payment_methods/visa/card_light.svg",
						"png_1x": "https://content.whop.com/payment_methods/visa/card_light_30.png",
						"png_2x": "https://content.whop.com/payment_methods/visa/card_light_60.png",
						"png_4x": "https://content.whop.com/payment_methods/visa/card_light_120.png"
					},
					"dark": {
						"svg": "https://content.whop.com/payment_methods/visa/card_dark.svg",
						"png_1x": "https://content.whop.com/payment_methods/visa/card_dark_30.png",
						"png_2x": "https://content.whop.com/payment_methods/visa/card_dark_60.png",
						"png_4x": "https://content.whop.com/payment_methods/visa/card_dark_120.png"
					}
				}
			},
			"card": {
				"brand": "visa",
				"last4": "4242",
				"issuer_identification_number": "41111111",
				"exp_month": 11,
				"exp_year": 2030,
				"network_transaction_id": "016153570198200"
			},
			"installment_count": null
		}
	},
	"line_items": [
		{
			"id": "li_xxxxxxxxxxxxx",
			"label": "Ceramic Coating Package",
			"variant_id": "plan_xxxxxxxxxxxxx",
			"variant_title": "One-time",
			"product_id": "prod_xxxxxxxxxxxxx",
			"product_title": "Ceramic Coating Package",
			"quantity": 1,
			"sku": "CERAMIC-COAT-3YR",
			"subtotal": {
				"amount": "299.00",
				"currency": "usd",
				"decimals": 2,
				"display_decimals": 2
			}
		}
	],
	"variant_id": "plan_xxxxxxxxxxxxx",
	"product_id": "prod_xxxxxxxxxxxxx",
	"reason": "fraudulent",
	"reason_code": "10.4",
	"status": "needs_response",
	"updated_at": "2026-06-01T12:00:00Z"
}
```


## Related topics

- [Dışa Aktarmalar API'si](https://docs.whop.com/tr/api-reference/exports/export.md)
- [Deneyler API'si](https://docs.whop.com/tr/api-reference/experiments/experiment.md)
- [Kartlar API'si](https://docs.whop.com/tr/api-reference/cards/card.md)
