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

# Faturalar

> Bir müşteriyi API üzerinden numaralı bir faturayla faturalandırın ve ödemeyi kayıtlı bir yöntemden ya da barındırılan ödeme sayfasından tahsil edin.

Fatura, tek bir müşteriye hitaben, bir veya daha fazla varyantınız için düzenlenen numaralı bir hesap belgesidir. Varyant, genellikle bir ürün için sattığınız fiyat ve faturalandırma kurulumudur. Kimliği `plan_` ile başlar ve fatura kalemleri bunu `plan_id` olarak alır. Müşteri ödeme yapmadan önce onunla bir fiyat üzerinde anlaştığınızda faturayı kullanın; örneğin bir teklif, bir hizmet veya bir kurumsal sipariş için. Doğru olana kadar bir taslak oluşturursunuz, ardından toplamları kilitlemek ve ödemeye açmak için onu düzenlersiniz (issue). Göndermek (send) bunu yapar ve faturayı tek bir çağrıyla e-postayla iletir. Kod yazmadan panonuzdan fatura göndermek için [Fatura oluşturma ve gönderme](https://docs.whop.com/tr/manage-your-business/manage-payments/send-invoice.md) sayfasına bakın.

> [!NOTE]
>
> Bu sayfadaki faturalar her istekte `Api-Version-Date: 2026-10-24` veya daha yeni bir sürüm gerektirir. Daha eski bir sürüm içeren istekler, farklı çalışan eski fatura API'sine ulaşır. Bkz. [Başlamadan önce](#before-you-start).

## Bir fatura nasıl çalışır

Yerel bir fatura bir ödemedir. Kimliği `pay_` ile başlar ve müşteri ödeme yaptıktan sonra da aynı kalır; böylece onu [Retrieve Payment](https://docs.whop.com/tr/api-reference/payments/retrieve-payment.md) ile de okuyabilirsiniz. Her fatura ayrıca hesabınızın kendi sırasındaki bir sonraki numarayı alır; örneğin `#00000042` veya hesabınızın bir fatura öneki varsa `#ACME-00000042`.

1. Kalemler, bir müşteri ve faturalandırma ayrıntılarıyla **bir taslak oluşturursunuz**. Taslak hiçbir ücret tahsil etmez ve kimseye e-posta göndermez.
2. **Faturayı düzenlersiniz veya gönderirsiniz.** Düzenleme, nihai vergiyi hesaplar ve faturayı ödemeye açar. Gönderme ise faturayı düzenler ve hemen ya da planladığınız bir zamanda e-postayla iletir.
3. **Müşteri öder.** Faturayı düzenlediğinizde veya gönderdiğinizde Whop müşterinin kayıtlı ödeme yönteminden tahsilat yapar ya da müşteri Whop'un barındırılan ödeme sayfası üzerinden öder.
4. **Siparişi** `payment.succeeded` webhook'undan **karşılarsınız**.

Faturalar, bekleme listesi yerine `release_method: buy_now` olan, yani hemen satın alınabilen varyantları faturalandırır. Tek seferlik bir varyant bir kez faturalandırılır; yinelenen bir varyant ise fatura ödendiğinde bir abonelik başlatır. Belirli sayıda ödemeden sonra durdurmayı da kapsayan [Bir aboneliği faturalandırma](#invoice-a-subscription) bölümüne bakın.

## Başlamadan önce

### API sürümünü gönderin

`/invoices` iki farklı API sunar ve isteğinizin çözümlendiği `Api-Version-Date` hangisinin yanıt vereceğini belirler.

| Gönderdiğiniz | `/invoices` şunu sunar |
| - | - |
| `Api-Version-Date: 2026-10-24` veya daha yenisi | Bu sayfadaki yerel faturalar |
| Daha eski bir `Api-Version-Date` | [Eski fatura API'si](https://docs.whop.com/tr/api-reference/legacy/invoices/legacy-invoice.md) |
| Başlık yok | Kimlik bilginizin kayıtlı sürüm sabitlemesi. Sabitleme yoksa eski fatura API'si. |
| Yayımlanmış bir sürüm olmayan bir tarih | Bir `400` hatası |

Düzenleme, gönderme, planlanmış bir gönderimi iptal etme ve PDF oluşturma yalnızca yerel API'de bulunur; bu nedenle hangi sürümü gönderirseniz gönderin yerel faturalara ulaşır. `GET /invoices` ve `POST /invoices/{id}/void` gibi her iki API'de de bulunan yollar sürümü izler.

Bir anahtarın sabitlemesine güvenmek yerine başlığı her istekte gönderin; böylece anahtar değiştirmek sizi asla iki API arasında taşımaz. [API sürümleri](https://docs.whop.com/tr/developer/api/versioning.md) sabitlemeleri ve değişiklik günlüğünü açıklar.

| | Yerel faturalar | Eski faturalar |
| - | - | - |
| **ID** | `pay_`, ödemeyle aynı | `inv_` |
| **Neyi faturalandırırsınız** | `items` olarak tek seferlik ve yinelenen varyantlar | Tek seferlik veya yinelenen faturalandırma |
| **Fatura e-postası** | Send Invoice çağrıldığında gönderilir, `due_at` sonrasında hatırlatmalarla | Whop faturayı e-postayla gönderir ve hatırlatmalar yollar |
| **Webhook'lar** | `payment.*` | `invoice.*` |
| **Pano** | **Invoices** sekmesi: listelenir, oluşturulur ve gönderilir | **Legacy invoices** sekmesi |

Yerel API eski `inv_` faturalarını listelemez veya getirmez, eski API de yerel faturaları döndürmez.

### API'yi çağırın

Bu sayfadaki örnekler API'yi, her istekte sürüm başlığını gönderen küçük bir yardımcı aracılığıyla çağırır.

```typescript TypeScript theme={null}
const WHOP_API = "https://api.whop.com/api/v1";

export async function whop(method: string, path: string, body?: unknown, idempotencyKey?: string) {
	const response = await fetch(`${WHOP_API}${path}`, {
		method,
		headers: {
			Authorization: `Bearer ${process.env.WHOP_API_KEY}`,
			"Api-Version-Date": "2026-10-24",
			"Content-Type": "application/json",
			...(idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {}),
		},
		body: body === undefined ? undefined : JSON.stringify(body),
	});
	const data = await response.json();
	if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`);
	return data;
}
```

```python Python theme={null}
import os
import uuid

import requests

WHOP_API = "https://api.whop.com/api/v1"


def whop(method, path, body=None, idempotency_key=None):
    headers = {
        "Authorization": f"Bearer {os.environ['WHOP_API_KEY']}",
        "Api-Version-Date": "2026-10-24",
    }
    if idempotency_key:
        headers["Idempotency-Key"] = idempotency_key
    response = requests.request(method, f"{WHOP_API}{path}", json=body, headers=headers)
    data = response.json()
    if not response.ok:
        raise RuntimeError(f"{data['error']['type']}: {data['error']['message']}")
    return data
```

Bir yeniden denemenin asla ikinci bir fatura oluşturmaması veya bir işlemi tekrarlamaması için her `POST` isteğinde bir [`Idempotency-Key`](https://docs.whop.com/tr/developer/api/idempotency) gönderin. Generate Invoice PDF bunun istisnasıdır: her çağrı yeni bir dosya oluşturur, bu yüzden yanıtları yeniden oynatmaz.

## Bir taslak oluşturun

[Create Invoice](https://docs.whop.com/tr/api-reference/invoices/create-invoice.md), `POST /invoices` ile bir taslak kaydeder.

```typescript TypeScript theme={null}
const invoice = await whop(
	"POST",
	"/invoices",
	{
		account_id: "biz_xxxxxxxxxxxxx",
		email_address: "dana@example.com",
		customer_name: "Dana Lee",
		items: [{ plan_id: "plan_xxxxxxxxxxxxx", quantity: 2 }],
		due_at: "2026-11-30T17:00:00Z",
		billing_address: {
			line1: "123 Main St",
			city: "New York",
			state: "NY",
			postal_code: "10001",
			country: "US",
		},
		metadata: { order_id: "ord_1042" },
	},
	crypto.randomUUID(),
);

console.log(invoice.id, invoice.number, invoice.status); // pay_xxxxxxxxxxxxx #00000042 draft
```

```python Python theme={null}
invoice = whop(
    "POST",
    "/invoices",
    {
        "account_id": "biz_xxxxxxxxxxxxx",
        "email_address": "dana@example.com",
        "customer_name": "Dana Lee",
        "items": [{"plan_id": "plan_xxxxxxxxxxxxx", "quantity": 2}],
        "due_at": "2026-11-30T17:00:00Z",
        "billing_address": {
            "line1": "123 Main St",
            "city": "New York",
            "state": "NY",
            "postal_code": "10001",
            "country": "US",
        },
        "metadata": {"order_id": "ord_1042"},
    },
    idempotency_key=str(uuid.uuid4()),
)

print(invoice["id"], invoice["number"], invoice["status"])  # pay_xxxxxxxxxxxxx #00000042 draft
```

```bash cURL theme={null}
curl -X POST https://api.whop.com/api/v1/invoices \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Api-Version-Date: 2026-10-24" \
  -H "Idempotency-Key: 6f1c2a0e-3b7d-4d55-9a8e-2c4b1f0d9e21" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "biz_xxxxxxxxxxxxx",
    "email_address": "dana@example.com",
    "customer_name": "Dana Lee",
    "items": [{ "plan_id": "plan_xxxxxxxxxxxxx", "quantity": 2 }],
    "due_at": "2026-11-30T17:00:00Z",
    "billing_address": { "line1": "123 Main St", "city": "New York", "state": "NY", "postal_code": "10001", "country": "US" },
    "metadata": { "order_id": "ord_1042" }
  }'
```

Yanıt, taslakla birlikte `201 Created` olur. Taslak oluşturmak ücret tahsil etmez, e-posta göndermez ve webhook göndermez. Bu yanıt alanların bir alt kümesini gösterir:

```json theme={null}
{
	"id": "pay_xxxxxxxxxxxxx",
	"object": "invoice",
	"number": "#00000042",
	"status": "draft",
	"totals_status": "estimated",
	"member_id": "mber_xxxxxxxxxxxxx",
	"recipient_emails": ["dana@example.com"],
	"line_items": [
		{
			"id": "li_xxxxxxxxxxxxx",
			"plan_id": "plan_xxxxxxxxxxxxx",
			"product_id": "prod_xxxxxxxxxxxxx",
			"label": "Strategy workshop",
			"quantity": 2,
			"unit_amount": { "currency": "usd", "amount": "250.00", "decimals": 2, "display_decimals": 2 },
			"subtotal": { "currency": "usd", "amount": "500.00", "decimals": 2, "display_decimals": 2 }
		}
	],
	"subtotal": { "currency": "usd", "amount": "500.00", "decimals": 2, "display_decimals": 2 },
	"tax_amount": null,
	"total": { "currency": "usd", "amount": "500.00", "decimals": 2, "display_decimals": 2 },
	"amount_due": { "currency": "usd", "amount": "500.00", "decimals": 2, "display_decimals": 2 },
	"metadata": { "order_id": "ord_1042" }
}
```

`account_id`, faturayı düzenleyen hesaptır ve `biz_` önekine sahiptir. Bir hesap API anahtarı, kendi hesabını kullanmak için bunu atlayabilir. [Create Invoice](https://docs.whop.com/tr/api-reference/invoices/create-invoice.md) tüm istek ve yanıt alanlarını listeler.

Bir taslak, numarasını oluşturulduğu anda kullanır; bu nedenle attığınız bir taslak sıranızda bir boşluk bırakır. Bir taslağı atmak için [onu silin](#delete-an-invoice). Listenizde tutmak için bunun yerine [geçersiz kılın](#void-or-mark-uncollectible).

### Kalem ekleyin

`items` 1 ile 50 arasında kalem alır. Her kalem, mevcut bir varyant için `plan_id` ya da satır içinde bir varyant bulmak veya oluşturmak için `plan` alır; ayrıca isteğe bağlı bir `quantity` de alır.

Satır içi bir `plan`, [Create Payment](https://docs.whop.com/tr/api-reference/payments/create-payment.md) ile aynı bul-veya-oluştur girdisini kullanır; örneğin `{ "plan": { "product_id": "prod_xxxxxxxxxxxxx", "plan_type": "one_time", "initial_price": 250, "currency": "usd" } }`. Bunun için `plan:create` gerekir; satır içi bir `product` ise ayrıca ürün iznini, yani `access_pass:create` veya `access_pass:update` iznini gerektirir.

Oluşturma ve güncelleme işlemleri şu kuralları ihlal eden kalemleri reddeder:

* Her kalem, hesabınıza ait hemen satın alınabilen bir varyanttır. Bir varyant yalnızca bir kez yer alır; daha fazla birim için `quantity` kullanın.
* Hiçbir varyant arşivlenmiş değildir ve bir taslağı düzenlemek veya göndermek bunu yeniden kontrol eder; bu nedenle varyantı arşivden çıkarın veya başka bir varyant seçin.
* `quantity` 1 ile 999.999 arasındadır ve yalnızca birden fazla miktara izin veren bir varyant için 1'in üzerindedir. Yinelenen varyantlar buna izin vermez, bu yüzden yinelenen bir kalemin miktarı 1'dir.
* Yinelenen bir varyant bir ürüne ait olmalıdır.
* Her kalem aynı para birimini kullanır.
* Birden fazla kalem içeren bir faturada, ürünü olan her kalem bir uygulama değil, normal bir ürün (standart ürün türü) olmalıdır. Yinelenen kalemler tek bir faturalandırma dönemini, ücretsiz deneme süresini ve `split_pay_required_payments` değerini paylaşır; tüm kalemlerin uyumlu ödeme, vergi ve erişim ayarlarına sahip olması gerekir. Özel alanlara veya parolaya sahip varyantlar birleştirilemez. Özel bir ücret gibi ürünü olmayan kalemler diğerlerinin yanında yer alabilir.

Yanıttaki her satır kaleminin bir `label` değeri vardır; bu ürünün başlığıdır veya ürünü olmayan bir varyant için varyantın başlığıdır. E-posta, PDF ve ödeme sayfası bunu gösterir.

Taslak, kalemlerini kaydettiğiniz andaki her varyantın fiyatını korur; böylece varyantta sonradan yapılan bir fiyat değişikliği faturayı etkilemez. Tek seferlik bir kalem kendi fiyatından faturalandırılır. `2026-11-11` API sürümünden itibaren, yinelenen bir kalem oluşturmak veya değiştirmek, ilk faturaya kalemin `initial_price` ve `renewal_price` toplamını dahil eder. Daha eski sürüm sabitlemeleri yalnızca yenileme fiyatını kullanır. `items` alanını atlayan düzenlemeler kayıtlı fiyatları korur.

### Müşteriyi ve faturalandırma ayrıntılarını ayarlayın

| Alan | Ne yapar |
| - | - |
| `member_id` | Müşteri; hesabın `mber_` önekli mevcut bir üyesi. |
| `email_address`, `customer_name` | `member_id` yerine e-postayla belirtilen müşteri. Whop, o e-postaya sahip hesap üyesini, ardından o e-postaya sahip bir Whop kullanıcısını kullanır ve ikisi de yoksa bir kullanıcı oluşturur. `customer_name` yeni kullanıcıya ad verir. |
| `billing_address` | Müşteri için `line1`, `city`, `postal_code` ve ISO 3166-1 alpha-2 `country` ile isteğe bağlı `name`, `line2`, `state` ve `phone` alanlarını içeren yeni bir faturalandırma adresi. |
| `mailing_address_id` | Bunun yerine müşterinin `ma_` önekli kayıtlı adreslerinden biri. |
| `payment_method_id` | Müşterinin `payt_` önekli kayıtlı bir ödeme yöntemi. Faturayı düzenlediğinizde Whop bu yöntemden tahsilat yapar. Bkz. [Kayıtlı bir ödeme yönteminden tahsilat yapma](#charge-a-saved-payment-method). |
| `due_at` | Ödemenin vadesi, ISO 8601 zaman damgası olarak. `overdue` durumunu, hatırlatma tarihlerini ve e-posta, PDF ve ödeme sayfasında gösterilen vade tarihini belirler. |
| `buyer_fee_percentage` | Alıcının ödediği, ara toplamın en fazla iki ondalık basamaklı, 0 ile 100 arasında bir yüzdesi olarak belirtilen ücret. Yanıt, yüzdeyi `buyer_fee_percentage` ve ücreti `buyer_fee_amount` olarak döndürür. |
| `recipient_emails` | Faturalandırılan müşteriden ayrı olarak fatura e-postasını alan en fazla 50 adres. Taslağı oluşturduğunuzda varsayılan olarak müşterinin e-postasıdır. Bunu atlayan bir güncelleme, müşteri değişse bile kayıtlı listeyi korur. Kaydetmek e-posta göndermez. Bkz. [E-postayı kimler alır](#who-gets-the-email). |
| `metadata` | Size ait en fazla 50 dize anahtar-değer çifti. Whop bunları, faturayı düzenlediğinizde oluşturduğu üyeliğe ve otomatik tahsilata kopyalar. |

`member_id` veya `email_address` ile `billing_address` veya `mailing_address_id` gönderin; bir çiftin ikisini birden asla göndermeyin. Faturalandırma adresi bir müşteri gerektirir. Müşteri taslakta isteğe bağlıdır ancak düzenlemek için zorunludur.

Whop, faturayı düzenlediğinizde müşterinin konumunu belirlemek için faturalandırma adresini kullanarak vergiyi hesaplar. Vergi uygulandığında ve Whop müşterinin nerede olduğunu belirleyemediğinde düzenleme reddedilir; bu nedenle vergi tahsil ettiğiniz her durumda bir faturalandırma adresi ekleyin.

### Bir taslağı düzenleyin

[Update Invoice](https://docs.whop.com/tr/api-reference/invoices/update-invoice.md), `PATCH /invoices/{id}` ile bir taslağı değiştirir. Yalnızca değiştirdiğiniz alanları gönderin.

```typescript TypeScript theme={null}
const updated = await whop("PATCH", `/invoices/${invoice.id}`, {
	items: [
		{ plan_id: "plan_xxxxxxxxxxxxx", quantity: 3 },
		{ plan_id: "plan_yyyyyyyyyyyyy" },
	],
	buyer_fee_percentage: 2.5,
});
```

```python Python theme={null}
updated = whop(
    "PATCH",
    f"/invoices/{invoice['id']}",
    {
        "items": [
            {"plan_id": "plan_xxxxxxxxxxxxx", "quantity": 3},
            {"plan_id": "plan_yyyyyyyyyyyyy"},
        ],
        "buyer_fee_percentage": 2.5,
    },
)
```

* `items` tüm listeyi değiştirir ve her varyantın güncel fiyatını okur. Kayıtlı kalemleri ve fiyatları korumak için bunu atlayın.
* `member_id` değiştirmek, yenilerini göndermediğiniz sürece kayıtlı faturalandırma adresini ve ödeme yöntemini kaldırır. `recipient_emails` korunur; bu yüzden yeni bir liste de gönderin, aksi halde önceki müşteri fatura e-postasını almaya devam eder.
* `email_address` ve `customer_name` kabul edilmez. Başka birini faturalandırmak için farklı bir `member_id` gönderin.
* [Planlanmış gönderimi](#schedule-a-send) olan bir taslak, gönderimi iptal edene kadar yalnızca `recipient_emails` değişikliğini kabul eder.
* Fatura düzenlendikten sonra yapabileceğiniz tek değişiklik, tek başına gönderilen `recipient_emails` değişikliğidir ve bu yalnızca fatura `open` veya `uncollectible` durumundayken mümkündür. Diğer tüm düzenlemeler `400` ile reddedilir.

## Müşterinin nasıl ödeyeceğini seçin

Düzenlenmiş bir fatura için ödeme almanın iki yolu vardır. Kayıtlı ödeme yöntemi taslağa eklendiğinden, faturayı düzenlemeden önce birini seçin.

| | Kayıtlı bir ödeme yönteminden tahsilat | Müşteri ödeme sayfası üzerinden öder |
| - | - | - |
| **Müşteri mevcut mu** | Hayır. Whop yöntemden oturum dışı tahsilat yapar. | Evet, Whop'un barındırılan ödeme sayfasında |
| **Neye ihtiyacınız var** | Taslakta `payment_method_id` | Faturanın `checkout_link` değeri |
| **3D Secure** | Tahsilat bir doğrulama adımını tamamlayamaz | Müşteri bunu tamamlar |
| **Ödeme kurallarınız** | `block` ve `allow` uygulanır | Dört eylemin tümü uygulanır |

Düzenlenmiş bir fatura, kayıtlı bir ödeme yöntemi olsa bile bir `checkout_link` alır. Otomatik tahsilat başarısız olursa müşteri yine de ödeme sayfası üzerinden ödeyebilir.

### Kayıtlı bir ödeme yönteminden tahsilat yapın

`payment_method_id` ile taslağa kayıtlı bir ödeme yöntemi ekleyin. Bu, müşterinin kayıtlı yöntemlerinden biri olmalıdır. [Ödeme yöntemlerini kaydetme](https://docs.whop.com/tr/developer/guides/save-payment-methods.md) bir müşterinin yöntemi nasıl kaydettiğini gösterir; [List payment methods](https://docs.whop.com/tr/api-reference/legacy/payment-methods/list-payment-methods.md) ise bir üyenin sahip olduğu yöntemleri bulur.

Faturayı düzenlediğinizde veya gönderdiğinizde ve toplamı sıfırın üzerinde olduğunda Whop şunları yapar:

1. [Create Payment](https://docs.whop.com/tr/api-reference/payments/create-payment.md) işleminin kayıtlı bir ödeme yönteminde çalıştırdığı kontrollerin aynısını çalıştırır.
2. Faturalandırılan miktarlar için stok ayırır ve ödemenin ücretlerini hazırlar.
3. Faturayı `open` olarak döndürür ve yöntemden oturum dışı tahsilat yapar. Tahsilat, Issue Invoice veya Send Invoice çağrısına ilettiğiniz `charge_at` zamanında; aksi halde hâlâ ilerideyse `due_at` zamanında; aksi halde hemen gerçekleşir. `scheduled_charge_at` henüz gerçekleşmemiş bir tahsilatı gösterir.

Yanıt, tahsilatın başarılı olup olmadığını söylemez. Siparişi faturanın `pay_` kimliği için gelen [`payment.succeeded` webhook'undan](#webhooks) karşılayın. Ödenmiş bir fatura üyeliği tamamlar ve `metadata` değerleriniz tahsilatta ve üyelikte bulunur. [Fatura ödemelerinde ödeme kuralları](#payment-rules-on-invoice-payments), ödeme kurallarınızın tahsilatı nasıl denetlediğini açıklar.

### Otomatik tahsilat reddedilirse

Reddedilen bir tahsilat faturayı `open` durumunda bırakır ve ayrılan stoku geri verir. Son denemenin neden başarısız olduğunu öğrenmek için [faturayı bir ödeme olarak getirin](https://docs.whop.com/tr/api-reference/payments/retrieve-payment.md) ve `failure_message` değerini okuyun.

Tahsilat reddedildiğinde veya müşterinin işlem yapmasını gerektirdiğinde Whop, müşterinin bunun yerine ödeme sayfası üzerinden ödeyebilmesi için faturanın ödeme bağlantısını [alıcılarına](#who-gets-the-email) e-postayla gönderir. Bu, göndermeden düzenlediğiniz bir fatura için Whop'un gönderdiği tek e-postadır. Bir `checkout_link` ve `recipient_emails` içinde en az bir giriş gerektirir ve [gönderim sınırına](#send-limit) dahil edilmez.

> [!WARNING]
>
> Oturum dışı bir tahsilat müşteriye 3D Secure doğrulaması gösteremez. Müşterinin bankası bunu isterse otomatik tahsilat tamamlanmaz ve fatura, müşteri kimliğini doğrulayana veya başka bir yolla ödeyene kadar ödenmemiş kalır.

## Faturayı düzenleyin

[Issue Invoice](https://docs.whop.com/tr/api-reference/invoices/issue-invoice.md) bir taslağı açık bir faturaya dönüştürür. Whop faturayı yeniden kontrol eder, nihai vergiyi hesaplar ve `status` değerini `open`, `totals_status` değerini `final` olarak ayarlar. Faturanın kayıtlı bir ödeme yöntemi ve sıfırın üzerinde bir toplamı varsa Whop ardından [Kayıtlı bir ödeme yönteminden tahsilat yapın](#charge-a-saved-payment-method) bölümünde açıklandığı gibi tahsilat yapar.

```typescript TypeScript theme={null}
const issued = await whop("POST", `/invoices/${invoice.id}/issue`, undefined, crypto.randomUUID());

console.log(issued.status, issued.totals_status); // open final
```

```python Python theme={null}
issued = whop("POST", f"/invoices/{invoice['id']}/issue", idempotency_key=str(uuid.uuid4()))

print(issued["status"], issued["totals_status"])  # open final
```

```bash cURL theme={null}
curl -X POST https://api.whop.com/api/v1/invoices/pay_xxxxxxxxxxxxx/issue \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Api-Version-Date: 2026-10-24" \
  -H "Idempotency-Key: 0b6f2d3c-91a4-4c7e-8f1e-5a2d7c9b3e10"
```

* **Vergi kesinleşir.** `tax_amount` bir taslakta `null` olur ve faturayı düzenlediğinizde ayarlanır. `total` ve `amount_due` bunu içerir.
* Fatura bir ürünü faturalandırdığında **Whop müşterinin üyeliğini oluşturur**. Üyelik, fatura ödenene kadar erişim olmadan taslak durumunda kalır. Tüm kalemlerinin ürünü olmayan bir fatura üyelik almaz.
* **`payment.created` olayı**, faturanın `pay_` kimliği için **bir kez tetiklenir**.
* **Yeniden düzenlemek güvenlidir.** Zaten `open` olan bir faturayı düzenlemek aynı kontrolleri yeniden çalıştırır ve geçerlerse faturayı değiştirmeden döndürür: toplamları aynı kalır ve hiçbir şey yeniden tahsil edilmez.
* **Düzenleme faturayı e-postayla göndermez**; [reddedilen bir tahsilattan sonraki ödeme bağlantısı](#if-the-automatic-charge-is-declined) bunun istisnasıdır. Faturayı e-postayla iletmek için bunun yerine [gönderin](#send-schedule-and-remind) veya ödeme bağlantısını kendiniz iletin.

Reddedilen bir düzenleme hiçbir şeyi değiştirmez ve hiçbir şey tahsil etmez. Nedeni düzeltin ve faturayı yeniden düzenleyin. [Düzenleme hataları](#issue-errors) nedenleri listeler.

### Ödeme bağlantısını alın

Düzenlenmiş, `open` durumundaki bir fatura, `pay_xxxxxxxxxxxxx.<signature>` biçiminde imzalı bir değer olan bir `checkout_link` taşır. Bu, faturayı sabit fiyatıyla Whop'un barındırılan ödeme sayfasında açar.

**1. Bağlantıyı düzenlenmiş faturadan okuyun**

`checkout_link`, fatura `open` olmadığı sürece `null` olur; bu nedenle taslaklarda ve ödenmiş, geçersiz kılınmış veya tahsil edilemez faturalarda bulunmaz. Bir kurumsal alıcıya faturalandırılan, üyeliği iptal edilmiş bir faturada ve kimlik bilginizde `payment:charge` izni olmadığında da `null` olur. Kurumsal alıcı, bir kişi değil başka bir Whop hesabı olan müşteridir.

**2. Barındırılan ödeme sayfası URL'sini oluşturun**

Bağlantıyı ilk `.` karakterinden bölün: faturanın `pay_` kimliği bundan önce, token ise sonra gelir.

```typescript TypeScript theme={null}
const { id, checkout_link } = await whop("GET", `/invoices/${invoice.id}`);

if (checkout_link) {
	const token = checkout_link.slice(checkout_link.indexOf(".") + 1);
	const url = `https://whop.com/checkout/${id}/?token=${encodeURIComponent(token)}`;
	console.log(url);
}
```

```python Python theme={null}
from urllib.parse import quote

current = whop("GET", f"/invoices/{invoice['id']}")

if current["checkout_link"]:
    token = current["checkout_link"].split(".", 1)[1]
    url = f"https://whop.com/checkout/{current['id']}/?token={quote(token, safe='')}"
    print(url)
```

**3. Müşteriye gönderin**

Whop'un bağlantıyı e-postayla göndermesi için [faturayı gönderin](#send-schedule-and-remind) veya URL'yi kendi e-postanıza ya da fatura sayfanıza ekleyin. Bu bağlantı üzerinden yalnızca faturanın müşterisi ödeme yapabilir. Diğer herkes reddedilir ve faturanın müşterisi olarak oturum açması istenir. Bağlantı, fatura ödendiğinde, geçersiz kılındığında veya tahsil edilemez olarak işaretlendiğinde çalışmayı durdurur.

**4. Siparişi webhook'tan karşılayın**

Otomatik tahsilatta olduğu gibi faturanın `pay_` kimliği için `payment.succeeded` olayını dinleyin. [Webhook'lar](#webhooks) bir işleyici gösterir.

Ödeme sayfası, faturanın numarasını ve vade tarihini kalemlerinin yanında gösterir; vade tarihi geçtiğinde kırmızıya döner. Müşteri faturadaki kalemleri ve toplamı öder ve promosyon kodu ekleyemez.

## Gönderme, planlama ve hatırlatma

[Send Invoice](https://docs.whop.com/tr/api-reference/invoices/send-invoice.md), `POST /invoices/{id}/send` ile bir faturayı e-postayla gönderir. Bir taslağı göndermek, Issue Invoice ile aynı şekilde önce onu düzenler. `open` durumundaki bir faturayı göndermek onu yeniden e-postayla iletir.

```typescript TypeScript theme={null}
await whop("POST", `/invoices/${invoice.id}/send`, undefined, crypto.randomUUID());
```

```python Python theme={null}
whop("POST", f"/invoices/{invoice['id']}/send", idempotency_key=str(uuid.uuid4()))
```

E-posta, hesabınızın adını ve logosunu, fatura numarasını, toplamı, vade tarihini, her kalemi ve faturanın ödeme sayfasını açan bir düğmeyi gösterir. Whop yalnızca müşterinin e-postadan ödeyebileceği bir faturayı e-postayla gönderir. `open` durumundaki bir faturanın gönderilmesi için bir `checkout_link` gerekir; bir taslak ise kurumsal alıcı olmayan bir müşteri gerektirir. Kurumsal bir alıcıya faturalandırılan bir taslak, kayıtlı bir ödeme yöntemi varsa yine de gönderilebilir, çünkü bunun yerine tahsilat yapılır.

### E-postayı kimler alır

Her gönderim, her adrese ayrı bir e-posta olarak bir kez gönderilir; böylece alıcılar birbirlerinin adreslerini asla görmez. Adresler şunlardır:

* Müşterinin Whop hesabındaki e-posta; fatura PDF'i bunu **Bill to** altında yazdırır.
* `recipient_emails` içindeki her giriş.

Whop `recipient_emails` değerini küçük harflerle kaydeder ve listedeki tekrarları kaldırır; böylece her ikisinde de bulunan bir adres tek bir e-posta alır.

Boş bir `recipient_emails`, Whop'un müşteri dahil kimseye e-posta göndermeyeceği anlamına gelir. Whop'un bir faturayı e-postayla göndermesini engellemek için bunu kullanın:

* Send Invoice, bunun yerine kayıtlı bir ödeme yönteminden tahsilat yapmadığı sürece faturayı reddeder.
* Reddedilen bir tahsilattan sonra [ödeme bağlantısı](#if-the-automatic-charge-is-declined) gönderilmez.
* Hatırlatma gönderilmez. `open` durumundaki bir faturada `recipient_emails` değerini temizlemek kalan hatırlatmaları durdurur.

### Whop e-posta yerine ne zaman tahsilat yapar

`payment_method_id` içeren ve toplamı sıfırın üzerinde olan bir taslak, tıpkı düzenlediğinizde olduğu gibi e-postayla gönderilmek yerine tahsil edilir. [Otomatik tahsilat reddedilirse](#if-the-automatic-charge-is-declined) bölümü, tahsilat başarısız olduğunda ne olacağını açıklar. Böyle bir taslak boş bir `recipient_emails` ile gönderilebilir, çünkü kimsenin e-postaya ihtiyacı yoktur.

### Gönderim sınırı

Her fatura, onu düzenleyen gönderim dahil 24 saat içinde üç kez e-postayla gönderilebilir. Bu süre içindeki dördüncü bir gönderim, `error.code` değeri `invoice_send_limit_reached` olan bir `429` ile reddedilir. Hatırlatmalar, [reddedilen bir tahsilattan sonraki ödeme bağlantısı](#if-the-automatic-charge-is-declined) ve e-posta yerine tahsilat yapan bir gönderim bu sınıra dahil edilmez.

### Bir gönderimi planlayın

Bir taslağı bunun yerine daha sonra göndermek için `send_at` iletin. Taslak taslak olarak kalır ve zamanı `scheduled_send_at` içinde gösterir. O zaman geldiğinde Whop, Send Invoice'ı o anda çağırmışsınız gibi faturayı gönderir.

```typescript TypeScript theme={null}
const scheduled = await whop("POST", `/invoices/${invoice.id}/send`, { send_at: "2026-12-01T15:00:00Z" }, crypto.randomUUID());

console.log(scheduled.status, scheduled.scheduled_send_at); // draft 2026-12-01T15:00:00.000Z
```

```python Python theme={null}
scheduled = whop("POST", f"/invoices/{invoice['id']}/send", {"send_at": "2026-12-01T15:00:00Z"}, idempotency_key=str(uuid.uuid4()))

print(scheduled["status"], scheduled["scheduled_send_at"])  # draft 2026-12-01T15:00:00.000Z
```

* **Yalnızca bir taslak planlanabilir** ve `send_at` gelecekte olmalıdır. Whop, planladığınızda alıcıları ve ödeme bağlantısını hemen gönderimde olduğu gibi kontrol eder.
* Zamanı değiştirmek için **yeni bir `send_at` ile yeniden gönderin**.
* Gönderim gerçekleşene veya siz iptal edene kadar **düzenleme kilitlidir**. Yalnızca `recipient_emails` değerini değiştiren bir güncelleme yine de çalışır, ancak tahsil edilmeyecek bir taslaktan son alıcıyı kaldıramaz.
* `POST /invoices/{id}/unschedule` ile **[Cancel Scheduled Send](https://docs.whop.com/tr/api-reference/invoices/cancel-scheduled-send.md)**. `scheduled_send_at` yeniden `null` olur ve taslak tekrar düzenlenebilir. Planlanmış gönderimi olmayan bir faturayı iptal etmek onu değiştirmeden döndürür.
* **Planlanmış bir taslağı geçersiz kılmak** planlanmış gönderimini durdurur.

```typescript TypeScript theme={null}
await whop("POST", `/invoices/${invoice.id}/unschedule`, undefined, crypto.randomUUID());
```

```python Python theme={null}
whop("POST", f"/invoices/{invoice['id']}/unschedule", idempotency_key=str(uuid.uuid4()))
```

Whop vadesi gelen gönderimleri her dakika kontrol eder; bu nedenle planlanmış bir gönderim `send_at` zamanından yaklaşık bir dakika içinde gerçekleşir. Örneğin planladığınızdan bu yana bir varyant silindiği için reddedilirse fatura taslak olarak kalır, `scheduled_send_at` yeniden `null` olur ve API nedeni döndürmez. Diğer tüm hatalar yaklaşık her 10 dakikada bir, toplamda en fazla 12 deneme olacak şekilde yeniden denenir. Bir deneme başarılı olana veya Whop yeniden denemeyi bırakana kadar `scheduled_send_at`, `null` yerine bir sonraki denemenin zamanını gösterir. Faturanın `open` olduğunu doğrulamak için `send_at` zamanından sonra faturayı okuyun.

### Hatırlatmalar

Send Invoice, `due_at` değerine sahip bir faturayı e-postayla gönderdiğinde Whop ayrıca `due_at` tarihinden 1, 3, 7, 14, 30 ve 60 gün sonrası için hatırlatmalar planlar; tarihi geçmiş olanları atlar. Her hatırlatma faturayla aynı adreslere gider ve faturanın vadesinin kaç gün geçtiğini belirtir.

Hatırlatmalar yalnızca fatura `open` durumundayken gönderilir; bu nedenle fatura ödendiğinde, geçersiz kılındığında veya tahsil edilemez olarak işaretlendiğinde durur. Bir ödeme devam ederken vadesi gelen bir hatırlatma, ödeme tamamlanana kadar bekler. Göndermeden düzenlediğiniz veya e-posta yerine tahsil edilen bir fatura hatırlatma almaz.

### E-posta geçmişi

[List Invoice Sends](https://docs.whop.com/tr/api-reference/invoices/list-invoice-sends.md), `GET /invoices/{id}/sends` ile kaydedilmiş e-posta gruplarını en yeniden başlayarak döndürür. İlk ve tekrar e-postalarını, planlanmış e-postaları, hatırlatmaları ve kayıtlı bir ödeme yöntemine yapılan başarısız bir tahsilattan sonraki ödeme takiplerini içerir. En son kaydedilen gönderim için ilk girişi kullanın; daha eski girişleri okumak için `page_info.end_cursor` değerini `after` olarak kullanın. Manuel gruplar, faturanın daha önce tamamlanmış bir e-posta geçmişi yoksa `send`, aksi halde `resend` kullanır. Tür, tamamlanan grup kaydedildiğinde seçilir; bu nedenle birlikte kuyruğa alınan istekler tamamlanma sırasına göre sınıflandırılır. Daha önceki kaydedilmemiş e-postalar bilinmez olarak kalır.

Her giriş `kind`, `sent_at`, `recipient_count`, `recipients` ve `actor` alanlarını içerir. Geçmişi okumak `payment:basic:read` gerektirir. Adresler ayrıca `member:email:read` gerektirir; bu izin yoksa `recipients` boştur. Göndereni görmek ayrıca `company:authorized_user:read` gerektirir; aksi halde `actor` null olur. Otomatik gönderimlerde ve hesap API anahtarlarında da actor null olur.

Çalışan süreç, grubun tamamını teslimata gönderdikten sonra bir giriş ekler. Kısmi bir grup için, yalnızca bir yeniden deneme grubu tamamlarsa giriş ekler. Giriş, orijinal alıcı listesini korur. Kaydedilmiş bir grup, gelen kutusuna teslimatı doğrulamaz. E-posta gönderici, fatura veya alıcılar teslimattan önce değişirse mesajları engelleyebilir. Geçmiş, bu özellik kullanıma sunulmadan önce gönderilen e-postaları içermez. Bir faturayı e-posta göndermeden düzenlemek geçmişe giriş eklemez.

## Bir PDF indirin

[Generate Invoice PDF](https://docs.whop.com/tr/api-reference/invoices/generate-invoice-pdf.md) faturayı PDF olarak oluşturur ve ona kısa ömürlü bir bağlantı döndürür. `payment:basic:read` gerektirir ve her durumda çalışır.

```typescript TypeScript theme={null}
const pdf = await whop("POST", `/invoices/${invoice.id}/generate_pdf`);

console.log(pdf.url, pdf.expires_at);
```

```python Python theme={null}
pdf = whop("POST", f"/invoices/{invoice['id']}/generate_pdf")

print(pdf["url"], pdf["expires_at"])
```

Yanıtta `url` ve `expires_at` bulunur. Bağlantı 15 dakika çalışır ve ona sahip olan herkes dosyayı indirebilir. Süresi dolduğunda yeni bir bağlantı oluşturun.

PDF işletmenizle başlar: sayfanın başında hesabınızın adı yer alır ve alt bilgi, faturanın Whop Inc tarafından sizin adınıza ve sizin namınıza düzenlendiğini belirtir. Fatura numarasını, tarihini ve vade tarihini ve **Bill to** ayrıntılarını gösterir. Her kalem miktarını, birim fiyatını ve tutarını gösterir; ardından ara toplam, hizmet ücreti, vergi ve ödenecek tutar gelir. Yinelenen bir kalem içeren bir fatura ayrıca yenileme tutarını ve ne sıklıkla yenilendiğini belirtir. Bir taslağın PDF'i tahmini toplamlarını gösterir; vergi, faturayı düzenleyene kadar sıfırdır.

Bazı içerikler kimlik bilginizin izinlerine bağlıdır:

| İzin | PDF'e ekledikleri |
| - | - |
| `member:basic:read` | **Bill to** altında müşterinin adı. Bu izin olmadan PDF yalnızca faturalandırma adresinde kayıtlı bir adı gösterir. |
| `member:email:read` | **Bill to** altında müşterinin e-postası |
| `payment:charge` | `checkout_link` değeri olan bir faturada, faturanın ödeme sayfasını açan bir **Pay now** bağlantısı |

## Bir aboneliği faturalandırın

Müşteri faturayı ödediğinde bir abonelik başlatmak için faturaya yinelenen bir varyant ekleyin. Whop ardından aboneliği her faturalandırma döneminde bir kez yeniler.

1. **Fatura ilk dönemi ve varsa peşin ücreti faturalandırır.** Yinelenen bir kalem bir ürüne ait olmalıdır ve miktarı 1'dir. `2026-11-11` API sürümünden itibaren ilk faturası `initial_price` ile `renewal_price` toplamını faturalandırır. Varyantın ücretsiz bir denemesi yoksa ödeme, ilk ücretli faturalandırma dönemini hemen başlatır. Varsa abonelik [denemeyle başlar](#start-with-a-free-trial). Panoda, özel bir yinelenen kalemin isteğe bağlı bir **Upfront fee** alanı vardır. Satır kaleminin `initial_price` değeri `unit_amount` içindeki bu tek seferlik kısmı belirtir; fatura sayfası, e-posta ve PDF bunu kendi **Upfront fee** satırında listeler.
2. Whop kayıtlı ödeme yönteminden düzenleme sırasında tahsilat yapsa da müşteri `checkout_link` üzerinden ödese de **faturanın ödenmesi aboneliği başlatır**. İlk dönem ödemeyle başlar. Bağlantıdan açılan ödeme sayfası, faturanın alıcı ücreti dahil yenileme tutarını ve ne sıklıkla yenilendiğini belirtir.
3. **Her yenileme, faturayı düzenlerken veya gönderirken seçtiğiniz şekilde tahsil edilir.** Yalnızca yinelenen kalemleri, faturanın alıcı ücretiyle birlikte, her varyantın faturayı düzenlediğiniz andaki yenileme fiyatından faturalandırır. Kalemleri kaydettikten sonra varyantın fiyatı değiştiyse bu, taslakta kayıtlı fiyattan farklı olabilir. Tek seferlik kalemler bir kez faturalandırılır.

Yenilemelerin nasıl tahsil edileceğini seçmek için [Issue Invoice](https://docs.whop.com/tr/api-reference/invoices/issue-invoice.md) veya [Send Invoice](https://docs.whop.com/tr/api-reference/invoices/send-invoice.md) çağrısına `collection_method` iletin. Planlanmış bir gönderim, planlarken kullandığınız `collection_method` değerini uygular; taslak bunu `scheduled_collection_method` olarak gösterir.

| `collection_method` | Her yenileme |
| - | - |
| `charge_automatically` | Faturayı ödeyen ödeme yönteminden tahsilat yapar: taslağın `payment_method_id` değeri veya müşterinin fatura bağlantısıyla ödediği yöntem. Varsayılan budur. |
| `send_invoice` | Yenileme tarihinde vadesi gelen yeni bir numaralı fatura düzenler ve bunu ödeme bağlantısı ve hatırlatmalarla birlikte en son faturanın `recipient_emails` adreslerine e-postayla gönderir |

`send_invoice` en az bir `recipient_emails` adresi gerektirir ve bir işletmeye faturalandırılan faturalar için kullanılamaz. Uygulandığı sürece faturanın son alıcısı kaldırılamaz. Yinelenen kalemi olmayan bir fatura `collection_method` değerini reddeder. İlk faturayı kartla ödemek `send_invoice` ayarını korur.

Her yenileme kendi `pay_` kimliği ve `payment.*` webhook'larıyla ayrı bir ödemedir. `charge_automatically` yenilemesi numaralı bir fatura değildir, bu nedenle List Invoices içinde görünmez. `send_invoice` yenilemesi List Invoices içinde numaralı bir faturadır ve Whop bunu otomatik olarak tahsil etmez. Abonelik, müşteri faturanın `checkout_link` bağlantısı üzerinden ödeyene kadar `past_due` durumunda kalır. Müşteri bu süre zarfında erişimini korur. Yenilemeleri durdurmak için [üyeliği iptal edin](https://docs.whop.com/tr/api-reference/memberships/cancel-membership.md). Üyelik iptal edildiğinde açık bir yenileme faturasının `checkout_link` bağlantısı çalışmayı durdurur.

Aboneliği bulmak için [faturayı bir ödeme olarak getirin](https://docs.whop.com/tr/api-reference/payments/retrieve-payment.md) ve `member:basic:read` gerektiren `membership_id` değerini okuyun.

### Ücretsiz bir denemeyle başlayın

Bir fatura, ödeme sayfasında olduğu gibi yinelenen bir varyantın `trial_period_days` değerine uyar. İlk fatura yalnızca varyantın `initial_price` değerini faturalandırır. Ödenmesi denemeyi başlatır ve ilk yenileme, deneme bittiğinde `renewal_price` değerini faturalandırır. 2026-11-16 17:00 UTC'den önce oluşturulan faturalar ilk dönemi faturalandırır ve denemeyi atlar.

* Varyanta daha önce aboneliği olan bir müşteri deneme almaz. İlk faturası `initial_price` ile `renewal_price` toplamını faturalandırır. Yenileme faturaları hiçbir zaman deneme başlatmaz.
* Deneme varyanttan gelir. Özel bir yinelenen kalem için `variant.trial_period_days` değerini ayarlayın. Kalem düzeyinde bir `trial_period_days` reddedilir.
* Faturadaki her yinelenen kalemin aynı deneme süresine sahip olması gerekir.
* Fatura hiçbir şey tahsil etmediğinde, denemeyi hemen başlatan bir `payment_method_id` ile veya `collection_method: "send_invoice"` ile düzenleyin ya da gönderin.
* Panoda, özel bir yinelenen kalemin bir **Free trial days** alanı vardır. Bir ürünün faturalandırma planı kendi denemesini gösterir.

### Belirli sayıda ödemeden sonra durdurun

Altı aylık ödeme gibi sabit bir ödeme planını faturalandırmak için yinelenen varyantta 2 ile 115 arasında bir `split_pay_required_payments` değeri ayarlayın. Fatura, varsa peşin ücret dahil ilk ödemedir. Örneğin 75 $peşin ücret ve üç adet 40$ taksit önce 115 $, ardından 40 $, ardından 40 \$ faturalandırır. Whop bu sayıda ödeme yapıldığında yenilemeyi durdurur ve üyelik aktif kalır. Müşteri bundan önce aboneliği kendisi iptal edemez, ancak siz edebilirsiniz. Abonelik iptal edilene kadar yenilemek için bunu ayarlamadan bırakın.

## Durumlar ve yaşam döngüsü

| `status` | Anlamı | Sonra ne olabilir |
| - | - | - |
| `draft` | Hâlâ düzenleyebilirsiniz. Toplamlar tahminidir ve vergi henüz hesaplanmamıştır. | Düzenler, gönderir, planlar, geçersiz kılar veya silersiniz |
| `open` | Düzenlenmiş. Toplamlar ve vergi kesindir ve fatura ödeme bekliyor. | Müşteri öder ya da siz geçersiz kılar veya tahsil edilemez olarak işaretlersiniz |
| `paid` | Müşteri ödedi. `amount_due` sıfırdır. | Hiçbir şey |
| `uncollectible` | Tahsil etmeyi beklemediğiniz bir açık fatura olarak işaretlediniz. | Geçersiz kılarsınız |
| `void` | İptal edildi. `amount_due` sıfırdır. | Silersiniz |

`status` değerlerini ödemelerden alır; bu nedenle bir fatura, bir ödeme devam ederken `pending` gibi bir ödeme durumu da gösterebilir. `totals_status` para alanlarının kesin olup olmadığını söyler: fatura taslakken `estimated`, düzenledikten sonra `final`. `overdue`, `due_at` tarihi geçmiş `open` veya `uncollectible` bir fatura için `true` olur.

### Geçersiz kılın veya tahsil edilemez olarak işaretleyin

[Void Invoice](https://docs.whop.com/tr/api-reference/invoices/void-invoice.md) `draft`, `open` veya `uncollectible` durumundaki bir faturayı iptal eder. Zaten geçersiz kılınmış bir faturayı geçersiz kılmak onu değiştirmeden döndürür; ödenmiş bir fatura ise geçersiz kılınamaz.

Tahsil etmeyi beklemediğinizi kaydetmek için [bir faturayı tahsil edilemez olarak işaretleyin](https://docs.whop.com/tr/api-reference/invoices/mark-invoice-uncollectible.md). Yalnızca `open` durumundaki bir fatura işaretlenebilir; tahsil edilemez bir faturayı yeniden işaretlemek onu değiştirmeden döndürür. Tahsil edilemez bir faturanın `checkout_link` değeri yoktur ve hatırlatma almaz.

Bu örnek, `open` durumundaki bir faturayı tahsil edilemez olarak işaretler, ardından geçersiz kılar:

```typescript TypeScript theme={null}
await whop("POST", `/invoices/${invoice.id}/mark_uncollectible`, undefined, crypto.randomUUID());

await whop("POST", `/invoices/${invoice.id}/void`, undefined, crypto.randomUUID());
```

```python Python theme={null}
whop("POST", f"/invoices/{invoice['id']}/mark_uncollectible", idempotency_key=str(uuid.uuid4()))

whop("POST", f"/invoices/{invoice['id']}/void", idempotency_key=str(uuid.uuid4()))
```

### Bir faturayı silin

[Delete Invoice](https://docs.whop.com/tr/api-reference/invoices/delete-invoice.md), `DELETE /invoices/{id}` ile `draft` veya `void` durumundaki bir faturayı kaldırır. Yanıt `{ id, deleted: true }` olur. Silinen bir fatura artık List Invoices veya List Payments içinde görünmez ve kimliği `404` döndürür. Bir silme işlemini geri alamazsınız.

`open` durumundaki bir faturayı silmeden önce geçersiz kılın. Planlanmış bir gönderimi veya tahsilatı olan bir taslak önce [Cancel Scheduled Send](https://docs.whop.com/tr/api-reference/invoices/cancel-scheduled-send.md) gerektirir. Taslak durumundaki bir yenileme faturası, bir aboneliği faturalandırdığı sürece silinemez. Para tahsil etmiş veya hâlâ bir banka havalesi bekleyen geçersiz kılınmış bir fatura silinemez; ödenmiş, beklemede veya tahsil edilemez bir fatura da silinemez. Bir faturanın `deletable` alanı, silinebildiğinde `true` olur.

Silme işlemi `invoice:update` veya `payment:charge` gerektirir. Silinen bir taslağın numarası yeniden kullanılmaz.

```typescript TypeScript theme={null}
await whop("DELETE", `/invoices/${invoice.id}`);
```

```python Python theme={null}
whop("DELETE", f"/invoices/{invoice['id']}")
```

## Faturaları listeleyin ve getirin

[List Invoices](https://docs.whop.com/tr/api-reference/invoices/list-invoices.md), kimlik bilginizin okuyabildiği faturaları en yeniden başlayarak döndürür. Bir API anahtarı kendi hesabını görür; bir kullanıcı token'ı ise kullanıcının ödemelerini okuyabildiği her hesabı görür. Listeyi şu sorgu parametreleriyle daraltın:

| Parametre | Filtreler |
| - | - |
| `account_id` | Tek bir hesap |
| `status` | `open` gibi tek bir durum. Bilinmeyen bir değer `400` olur. |
| `overdue` | Vadesi geçmiş faturalar için `true`, geri kalanı için `false` |
| `scheduled` | Planlanmış taslaklar için `true`, geri kalanı için `false` |
| `member_id` | Tek bir müşteri |
| `product_id` | `prod_` önekli bir ürünü faturalandıran faturalar |
| `created_after`, `created_before` | ISO 8601 zaman damgaları olarak bir oluşturma aralığı |

Planlanmış bir taslak, `scheduled_send_at` değerine sahip olandır. `open` durumundaki bir fatura hiçbir zaman planlanmış değildir; vade tarihinde gönderilen bir taslak da öyle değildir.

`order` (`created_at`, `due_at` veya `scheduled_send_at`) ve `direction` (`asc` veya `desc`) ile sıralayın. `due_at` veya `scheduled_send_at` ile sıralama, o tarihe sahip olmayan faturaları sona koyar. Yanıt `{ data, page_info }` olur. `page_info.has_next_page` `true` olduğu sürece sonraki sayfayı okumak için `page_info.end_cursor` değerini `after` olarak iletin.

```typescript TypeScript theme={null}
const overdue = await whop("GET", "/invoices?account_id=biz_xxxxxxxxxxxxx&overdue=true&order=due_at&direction=asc");

for (const invoice of overdue.data) {
	console.log(invoice.number, invoice.due_at, invoice.amount_due.amount);
}
```

```python Python theme={null}
overdue = whop("GET", "/invoices?account_id=biz_xxxxxxxxxxxxx&overdue=true&order=due_at&direction=asc")

for invoice in overdue["data"]:
    print(invoice["number"], invoice["due_at"], invoice["amount_due"]["amount"])
```

[Retrieve Invoice](https://docs.whop.com/tr/api-reference/invoices/retrieve-invoice.md) bir faturayı `pay_` kimliğiyle okur. [List Payments](https://docs.whop.com/tr/api-reference/payments/list-payments.md) taslakları dışarıda bırakır.

Faturaları CSV dosyası olarak dışa aktarmak için [Create Export](https://docs.whop.com/tr/api-reference/exports/create-export.md) çağrısını `resource: "receipt_invoices"` ile yapın. Bu, `payment:basic:read` ve `payment:basic:export` gerektirir. Müşteri sütunları yalnızca kimlik bilginizde ayrıca `member:basic:read` veya `member:email:read` bulunduğunda görünür.

## Webhook'lar

Yerel faturalar, `pay_` kimlikleri için ödeme webhook'ları gönderir. `invoice.*` olayları eski fatura API'sine aittir ve yerel faturalar bunları göndermez.

| Olay | Ne zaman |
| - | - |
| `payment.created` | Faturayı düzenlediğinizde. Taslaklar hiçbir şey göndermez. |
| `payment.succeeded` | Fatura ödendiğinde. Siparişi bu olaydan karşılayın. |

`payment.failed` gibi diğer `payment.*` olayları da ödeme denemeleri değiştikçe faturanın `pay_` kimliği için gelebilir. Bunlara [webhook kılavuzu](https://docs.whop.com/tr/developer/guides/webhooks.md) ile abone olun.

Bir siparişi karşılamak için taslağı oluştururken faturanın `id` değerini siparişle birlikte kaydedin. Bir `payment.succeeded` olayının `data` alanı ödemedir, bu nedenle `data.id` faturanın `pay_` kimliğidir. [Olayı doğruladıktan](https://docs.whop.com/tr/developer/guides/webhooks.md#verify-and-handle-events) sonra siparişi bu kimlikle arayın. Bu işleyicide `orders` kendi sipariş deponuzu temsil eder:

```typescript TypeScript theme={null}
export async function handleWhopEvent(event: { type: string; data: { id: string } }) {
	if (event.type !== "payment.succeeded") return;

	const order = await orders.findByInvoiceId(event.data.id);
	if (!order || order.fulfilled) return;

	await orders.fulfill(order.id);
}
```

```python Python theme={null}
def handle_whop_event(event):
    if event["type"] != "payment.succeeded":
        return

    order = orders.find_by_invoice_id(event["data"]["id"])
    if order is None or order.fulfilled:
        return

    orders.fulfill(order.id)
```

`fulfilled` kontrolü, yeniden teslim edilen bir olayın siparişi iki kez karşılamasını önler. Abonelik yenilemelerinin kendi `pay_` kimlikleri vardır, bu nedenle bir faturayla eşleşmezler.

## Fatura ödemelerinde ödeme kuralları

[Ödeme kurallarınız](https://docs.whop.com/tr/developer/guides/manage-fraud.md), herhangi bir ödeme sayfasında olduğu gibi fatura ödemelerinde de Whop'un kendi dolandırıcılık taramasından sonra çalışır. Neler yapabilecekleri müşterinin mevcut olup olmadığına bağlıdır.

* **Düzenleme sırasındaki otomatik tahsilat oturum dışıdır.** Bir `block` kuralı onu reddeder, bir `allow` kuralı ise onu diğer kurallarınızdan muaf tutar. Tahsilat oturum dışı olduğundan `review` ve `enforce_3ds` kuralları atlanır.
* **Ödeme bağlantısı üzerinden yapılan bir ödeme oturum içidir.** [Dolandırıcılığı yönetme](https://docs.whop.com/tr/developer/guides/manage-fraud.md) bölümündeki uygunluk sınırlarıyla birlikte dört eylemin tümü uygulanır.

Otomatik tahsilatta kart koşulları kayıtlı ödeme yöntemini, faturalandırma koşulları ise faturanın faturalandırma adresini okur. `customer_email`, müşterinin Whop hesabındaki e-postadır. Ödemenin `payment_rule_matches` alanı kararı veren kuralı listeler. Atlanan bir kural listelenmez.

## Panodaki faturalar

**Invoices** sayfası yerel faturaları listeler, oluşturur ve gönderir. Eski faturalar, [Fatura gönderme](https://docs.whop.com/tr/payments/send-an-invoice.md) sayfasının ele aldığı **Legacy invoices** sekmesindedir.

## İzinler

| Çağrı | İzin |
| - | - |
| [Oluşturma](https://docs.whop.com/tr/api-reference/invoices/create-invoice.md), [güncelleme](https://docs.whop.com/tr/api-reference/invoices/update-invoice.md), [düzenleme](https://docs.whop.com/tr/api-reference/invoices/issue-invoice.md), [gönderme](https://docs.whop.com/tr/api-reference/invoices/send-invoice.md), [planlanmış gönderimi iptal etme](https://docs.whop.com/tr/api-reference/invoices/cancel-scheduled-send.md), [geçersiz kılma](https://docs.whop.com/tr/api-reference/invoices/void-invoice.md) veya [tahsil edilemez olarak işaretleme](https://docs.whop.com/tr/api-reference/invoices/mark-invoice-uncollectible.md) | `payment:charge` |
| [Listeleme](https://docs.whop.com/tr/api-reference/invoices/list-invoices.md), [getirme](https://docs.whop.com/tr/api-reference/invoices/retrieve-invoice.md) veya [PDF oluşturma](https://docs.whop.com/tr/api-reference/invoices/generate-invoice-pdf.md) | `payment:basic:read` |

Her yazma işlemi, [Create Payment](https://docs.whop.com/tr/api-reference/payments/create-payment.md) ile aynı izin olan `payment:charge` gerektirir; her okuma işlemi ise `payment:basic:read` gerektirir. `invoice:*` izinleri eski fatura API'sine aittir ve yerel faturalar bunları kullanmaz. Satır içi bir `plan` kalemi gönderen bir oluşturma veya güncelleme ayrıca `plan:create` gerektirir.

Bazı alanlar kendi izinlerini gerektirir. Bu izin olmadan alan `null` olarak döner ve `recipient_emails` boş döner.

| İzin | Görünür kıldığı alanlar |
| - | - |
| `member:basic:read` | `member_id`, `customer_name` |
| `member:email:read` | `email_address`, `recipient_emails` |
| `payment:basic:read` | `payment_method_id`, `mailing_address_id`, `billing_address` |
| `payment:charge` | `checkout_link` |

Kimlik bilginiz bir `POST` isteğinden sonra bu okuma izinlerinden birini kaybederse, kayıtlı yanıt bu alanları gösterdiğinde isteği aynı `Idempotency-Key` ile yeniden oynatmak, `error.code` değeri `invoice_replay_permission_revoked` olan bir `403` ile reddedilir. Bunun yerine faturayı `GET` ile getirin. İzinleri [İzinler kılavuzundan](https://docs.whop.com/tr/developer/guides/permissions.md) ekleyin.

## Hatalar

Retler `{ error: { type, message, code } }` olarak döner. Aksi belirtilmedikçe aşağıdaki her kod bir `400` olur. Bilinmeyen bir `plan_id`, `member_id`, `mailing_address_id` veya `payment_method_id` bir `404` olur; Whop'un okuyamadığı bir zaman damgası ise `invalid_timestamp` ile bir `400` olur.

Bu retler `error.code` içermeyen bir `400` olur; bu nedenle nedeni öğrenmek için `error.message` değerini okuyun:

* Bilinmeyen bir üst düzey alan.
* 1 ile 999.999 aralığının dışında bir `quantity`.
* `recipient_emails` içinde geçersiz bir adres veya 50'den fazla adres.
* Faturalandırma dönemi uyuşmazlığı gibi ihlal edilmiş bir çoklu kalem kuralı.

### Oluşturma ve güncelleme hataları

| `error.code` | Neden |
| - | - |
| `invoice_item_count_invalid`, `invoice_item_invalid` | `items` 1 ile 50 arasında giriş içermiyor veya bir kalemde `plan_id` ve `plan` alanlarından tam olarak biri yok. |
| `invoice_plan_account_mismatch`, `invoice_plan_duplicated`, `invoice_currency_mismatch` | Bir varyant başka bir hesaba ait, iki kez yer alıyor veya diğerlerinden farklı bir para birimi kullanıyor. |
| `invoice_quantity_unsupported` | Birden fazla miktara izin vermeyen bir varyant için `quantity` 1'in üzerinde. |
| `invoice_plan_type_unsupported`, `invoice_legacy_plan_unsupported` | Varyant hemen satın alınabilir değil veya eski bir faturaya ait. |
| `invoice_installment_count_mismatch` | Faturadaki yinelenen kalemler farklı sayıda ödemeden sonra duruyor. |
| `invoice_recurring_plan_product_required` | Yinelenen bir varyantın ürünü yok. |
| `invoice_plan_unavailable`, `invoice_plan_archived`, `invoice_plan_currency_changed` | Bir varyant silindi veya arşivlendi ya da kayıtlı bir varyantın para birimi değişti. `items` değerini yeniden gönderin. |
| `invoice_customer_ambiguous`, `invoice_address_ambiguous` | Hem `member_id` hem `email_address` ya da hem `billing_address` hem `mailing_address_id` gönderdiniz. |
| `invoice_address_properties_invalid`, `invoice_address_incomplete`, `invoice_address_country_invalid` | `billing_address` bilinmeyen bir alan içeriyor, zorunlu bir alanı eksik veya geçerli bir kod olmayan bir `country` değerine sahip. |
| `invoice_address_member_required`, `invoice_member_mismatch`, `invoice_address_mismatch`, `invoice_payment_method_mismatch` | Adresin müşterisi yok ya da üye, adres veya ödeme yöntemi başka birine ait. |
| `invoice_payment_method_unsupported` | Kayıtlı ödeme yöntemi fatura ödeyemiyor. |
| `invoice_buyer_fee_invalid`, `invoice_metadata_invalid`, `invoice_recipients_invalid` | `buyer_fee_percentage` aralık dışında, bir `metadata` değeri dize değil veya `recipient_emails` bir dizi değil. |
| `invoice_not_editable`, `invoice_recipients_not_editable` | Fatura bir taslak değil veya bir `recipient_emails` değişikliği taslak, `open` ya da `uncollectible` olmayan bir faturaya ulaştı. |
| `invoice_scheduled_not_editable`, `invoice_scheduled_recipients_required` | Taslağın planlanmış bir gönderimi var. Düzenlemeden veya son alıcıyı kaldırmadan önce onu iptal edin. |

### Düzenleme hataları

| `error.code` | Neden |
| - | - |
| `invoice_not_issuable` | Fatura bir taslak veya `open` değil. |
| `invoice_recipient_required` | Faturanın müşterisi yok. |
| `invoice_account_verification_required` | Hesabınız doğrulamayı tamamlamadı. |
| `invoice_account_suspended` | Hesabınız askıya alındı. |
| `invoice_items_required`, `invoice_items_changed`, `invoice_plan_unavailable`, `invoice_plan_archived` | Faturanın kalemi yok ya da bir varyant silindi, arşivlendi veya hesabı, para birimi ya da ürünü değişti. Kalemleri güncelleyin. |
| `invoice_tax_address_required` | Vergi uygulanıyor ve Whop müşterinin nerede olduğunu belirleyemiyor. Bir faturalandırma adresi ekleyin. |
| `invoice_tax_unresolved` | Vergi hesaplanamadı. |
| `invoice_changed_during_issuance`, `invoice_changed_during_calculation` | Vergi hesaplanırken fatura değişti. Yeniden düzenleyin. |
| `invoice_payment_method_unavailable`, `invoice_payment_method_unsupported`, `payment_method_unavailable` | Kayıtlı ödeme yöntemi müşteriden kaldırıldı, fatura ödeyemiyor veya artık çalışmıyor. |
| `out_of_stock` | Yalnızca kayıtlı bir ödeme yönteminden tahsilat yapılırken: bir varyantın faturalandırılan miktar için yeterli stoku yok. |
| `payment_fees_unavailable` | Yalnızca kayıtlı bir ödeme yönteminden tahsilat yapılırken: ödemenin ücretleri hazırlanamadı. |

### Gönderme ve planlama hataları

Bir taslağı göndermek onu düzenler; bu nedenle bir gönderim [Düzenleme hataları](#issue-errors) bölümündeki herhangi bir nedenle de reddedilebilir.

| `error.code` | Neden |
| - | - |
| `invoice_not_sendable` | Fatura bir taslak veya `open` değil. |
| `invoice_send_recipients_required` | Faturanın `recipient_emails` değeri yok ve tahsil edilecek bir şey yok. |
| `invoice_payment_link_unavailable` | E-postayla gönderilecek bir ödeme bağlantısı yok: `open` durumundaki bir faturanın `checkout_link` değeri yok veya kayıtlı ödeme yöntemi olmayan bir taslak kurumsal bir alıcıyı faturalandırıyor. |
| `invoice_send_limit_reached` | Bir `429`: fatura son 24 saat içinde zaten üç kez e-postayla gönderildi. |
| `invoice_not_schedulable` | Yalnızca bir taslak planlanabilir. |
| `invoice_scheduled_send_in_past` | `send_at` gelecekte değil. |

### Diğer hatalar

| `error.code` | Neden |
| - | - |
| `invoice_not_uncollectible` | Yalnızca `open` durumundaki bir fatura tahsil edilemez olarak işaretlenebilir. |
| `invoice_replay_permission_revoked` | Bir `403`: idempotent bir yeniden oynatma, kimlik bilginizin artık okuyamadığı alanları gösterirdi. |

Ödenmiş bir faturayı geçersiz kılmak kodsuz bir `400` olur.

## Sonraki adımlar

> [card] [Faturalar API referansı](https://docs.whop.com/tr/api-reference/invoices/create-invoice.md)
>
> Tüm fatura uç noktaları, parametreleri ve yanıt alanları.

> [card] [Ödeme yöntemlerini kaydedin](https://docs.whop.com/tr/developer/guides/save-payment-methods.md)
>
> Bir faturanın düzenleme sırasında tahsilat yaptığı kayıtlı ödeme yöntemini toplayın.

> [card] [Dolandırıcılığı yönetin](https://docs.whop.com/tr/developer/guides/manage-fraud.md)
>
> Fatura ödemelerini denetleyen ödeme kurallarını yazın.

> [card] [Webhook'ları dinleyin](https://docs.whop.com/tr/developer/guides/webhooks.md)
>
> Faturalarınız için `payment.created` ve `payment.succeeded` olaylarını takip edin.


## Related topics

- [Eski faturalardan geçiş](https://docs.whop.com/tr/developer/guides/migrate-from-legacy-invoices.md)
- [Eski Fatura](https://docs.whop.com/tr/api-reference/legacy/invoices/legacy-invoice.md)
- [Charge Invoice](https://docs.whop.com/tr/api-reference/invoices/charge-invoice.md)
