> ## 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 API'si

> İade, Ödemeyi İade Et ile gerçekleştirilen, bir ödemenin tamamen veya kısmen geri alınmasıdır. Ne kadar tutarın hangi sağlayıcı üzerinden aktarıldığını ve başarılı olup olmadığını kaydeder.

İade, [Ödemeyi İade Et](https://docs.whop.com/tr/api-reference/payments/refund-payment.md) ile gerçekleştirilen, bir ödemenin tamamen veya kısmen geri alınmasıdır. Ne kadar tutarın hangi sağlayıcı üzerinden aktarıldığını ve başarılı olup olmadığını kaydeder.

İadeler API'sini bir ödemedeki veya bir hesap genelindeki iadeleri listelemek ve tek bir iadeyi almak için kullanın.

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [İadeleri Listele](https://docs.whop.com/tr/api-reference/refunds/list-refunds.md) | GET `/refunds` |
| [İadeyi Al](https://docs.whop.com/tr/api-reference/refunds/retrieve-refund.md) | GET `/refunds/{id}` |

## Öznitelikler

**id** `string` *required*

`rf_` önekli iade kimliği.

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

İadeyi gerçekleştiren `biz_` önekli hesap.

**amount** `object | null` *required*

Ödemenin uzlaşma para biriminde, uzlaştığı şekliyle iade edilen tutar; böylece iade sayfaları ödemenin `refunded_amount` değeriyle mahsup edilebilir. Ödemenin orijinal kuruyla değil, iade gerçekleştirildiğinde geçerli olan kurla dönüştürülür. Yalnızca eski bir çok para birimli ödeme için kayıtlı döviz kuru olmadığında 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 sayısının onu yuvarlamaması için dizedir.
>
> **currency** `string` *required*
>
> Küçük harfli, üç harfli ISO 4217 para birimi kodu.
>
> **decimals** `integer` *required*
>
> Tutarın kaç ondalık basamak taşıdığı. Bu, tahsilatın kendisinin çalıştığı
> hassasiyettir.
>
> **display\_decimals** `integer` *required*
>
> Kaç ondalık basamağın GÖSTERİLECEĞİ. Genellikle `decimals` ile eşittir, ancak bilinçli olarak her zaman değil: COP centavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu yüzden `2` ve `0` olur. Sayıyı bunu kullanarak kendi yerel ayarınızda biçimlendirin.

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

İadenin talep edildiği zaman, ISO 8601 zaman damgası olarak.

**failure\_message** `string | null` *required*

İadenin neden başarısız olduğuna dair satıcıya yönelik, isteğin dilinde bir
açıklama. İade başarısız olmadıkça veya iptal edilmedikçe null.

**failure\_reason** `string | null` *required*

İadenin neden başarısız olduğu, sağlayıcılar arasında normalleştirilmiş. İade başarısız olmadıkça veya iptal edilmedikçe null.

Kullanılabilir seçenekler: `bank_declined`, `expired_or_canceled_card`, `lost_or_stolen_card`, `insufficient_funds`, `charge_disputed`, `not_refundable`, `merchant_request`, `unknown`

**metadata** `object | null` *required*

İade talep edilirken eklenen kendi anahtar-değer verileriniz.

**original\_amount** `object` *required*

İşlemcinin aktardığı para birimindeki iade edilen tutar.

> [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 sayısının onu yuvarlamaması için dizedir.
>
> **currency** `string` *required*
>
> Küçük harfli, üç harfli ISO 4217 para birimi kodu.
>
> **decimals** `integer` *required*
>
> Tutarın kaç ondalık basamak taşıdığı. Bu, tahsilatın kendisinin çalıştığı
> hassasiyettir.
>
> **display\_decimals** `integer` *required*
>
> Kaç ondalık basamağın GÖSTERİLECEĞİ. Genellikle `decimals` ile eşittir, ancak bilinçli olarak her zaman değil: COP centavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu yüzden `2` ve `0` olur. Sayıyı bunu kullanarak kendi yerel ayarınızda biçimlendirin.

**payment\_id** `string` *required*

Bu iadenin geri aldığı `pay_` önekli ödeme.

**provider** `string` *required*

İadeyi işleyen ödeme sağlayıcısı, örneğin `paypal` veya `coinbase`.

**provider\_created\_at** `string | null` *required*

Sağlayıcının iadeyi oluşturduğu zaman, ISO 8601 zaman damgası olarak.

**reason** `string | null` *required*

Kaydedildiğinde, iadenin neden gerçekleştirildiği.

Kullanılabilir seçenekler: `duplicate`, `fraudulent`, `requested_by_customer`, `expired_uncaptured_charge`, `dispute_alert`

**reference\_status** `string | null` *required*

Bu iade için bir bankacılık ağı takip referansının mevcut olup olmadığı.

Kullanılabilir seçenekler: `available`, `pending`, `unavailable`

**reference\_type** `string | null` *required*

Takip referansının türü, örneğin bir alıcı banka referans numarası.

Kullanılabilir seçenekler: `acquirer_reference_number`, `retrieval_reference_number`, `system_trace_audit_number`

**reference\_value** `string | null` *required*

Alıcının bankasının iadeyi izleyebileceği takip referansı.

**status** `string` *required*

İadenin işlemcideki durumu: `pending`, `requires_action`, `succeeded`, `failed` veya `canceled`.

Kullanılabilir seçenekler: `pending`, `requires_action`, `succeeded`, `failed`, `canceled`

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

İadenin en son değiştiği zaman, ISO 8601 zaman damgası olarak.

**visa\_rdr** `boolean` *required*

Kart ağı iadeyi Rapid Dispute Resolution aracılığıyla başlattığında true.

```json Refund theme={null}
{
	"id": "rf_xxxxxxxxxxxxxx",
	"payment_id": "pay_xxxxxxxxxxxxxx",
	"account_id": "biz_xxxxxxxxxxxxxx",
	"status": "succeeded",
	"amount": {
		"amount": "49.00",
		"currency": "usd",
		"decimals": 2,
		"display_decimals": 2
	},
	"original_amount": {
		"amount": "49.00",
		"currency": "usd",
		"decimals": 2,
		"display_decimals": 2
	},
	"provider": "stripe",
	"reason": "requested_by_customer",
	"failure_reason": null,
	"failure_message": null,
	"reference_type": "acquirer_reference_number",
	"reference_status": "available",
	"reference_value": "74000006259000123456789",
	"visa_rdr": false,
	"metadata": {
		"refund_id": "ref_8f2k1"
	},
	"provider_created_at": "2026-09-15T14:30:02.000Z",
	"created_at": "2026-09-15T14:30:00.000Z",
	"updated_at": "2026-09-15T14:30:05.000Z"
}
```


## Related topics

- [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)
- [Kanallar API'si](https://docs.whop.com/tr/api-reference/channels/channel.md)
