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

# Eski faturalardan geçiş

> Eski fatura API'sinden yerel faturalara geçin: API sürümünü değiştirin, istekleri kalemler etrafında yeniden oluşturun ve alanları, durumları ve webhook'ları eşleyin.

Yerel faturalar eski faturalarla aynı `/invoices` yollarını kullanır, ancak farklı bir istek biçimine ve yaşam döngüsüne sahiptir. Bu kılavuz, bir entegrasyonu taşırken değiştirmeniz gereken alanları ve işlemleri eşler.

> [!NOTE]
>
> Ortak yollar `Api-Version-Date: 2026-10-24` sürümünden itibaren yerel faturalara yönlendirilir.
> Aşağıdaki yerel örnekler, güncel varyant alan adları ve müşteri kilitleme kurallarıyla
> `Api-Version-Date: 2026-11-02-1` kullanır. Bu başlığı her yerel istekte gönderin.
> Eski çağrıları `2026-10-15-1` gibi daha önce yayınlanmış bir sürümde tutun.
> [API sürümleri](https://docs.whop.com/tr/developer/api/versioning.md) başlıkların kimlik bilgisi sabitlemelerini
> nasıl geçersiz kıldığını açıklar.

## Neler değişiyor

| | Eski faturalar | Yerel faturalar |
| - | - | - |
| **Kimlik** | `inv_` | `pay_`, faturanın ödemesiyle aynı |
| **Faturalandırdığınız şey** | Fiyatına eklenen isteğe bağlı etiketlerle tek bir plan | Her biri mevcut bir varyant ya da satır içinde bulunan veya oluşturulan bir varyant olan 1 ila 50 kalem |
| **Oluşturma** | `save_as_draft` veya `automatically_finalizes_at` ayarlanmadıkça tek çağrıda kesinleşir | Her zaman taslak olarak kaydeder. Ardından düzenler veya gönderirsiniz. |
| **Tutarlar** | Planın fiyatı | `subtotal`, `buyer_fee_amount`, `tax_amount`, `total`, `amount_due` |
| **Ödeme sayfası** | `pay_online_url`, bir URL | `checkout_link`, ödeme sayfasını açmak için kullanılan imzalı bir token |
| **Vadesi geçmiş** | `status: past_due` | `open` veya `uncollectible` bir faturada `overdue: true` |
| **Webhook'lar** | `invoice.*` | Faturanın `pay_` kimliği için ödeme olayları |

Yerel API eski `inv_` faturalarını listelemez veya getirmez. Mevcut eski faturaları önceki API sürümüyle okumaya devam edin. Yerel bir fatura oluşturmak ayrı bir fatura oluşturur. Eski bir faturayı dönüştürmez veya kapatmaz.

## Geçişten önce

Bir akışı taşımadan önce bu farklılıkları kontrol edin. Akış, yerel API'nin sağlamadığı bir özelliğe ihtiyaç duyuyorsa onu eski API'de tutun.

| Eski özellik | Yerel davranış |
| - | - |
| `invoice.*` webhook'ları | Yerel faturalar ödeme olaylarını kullanır. Bazı eski olayların doğrudan karşılığı yoktur. Bkz. [Webhook'ları eşleyin](#map-webhooks). |
| Whop dışında tahsilat yaptıktan sonra bir faturayı ödendi olarak işaretleme | Yerel bir `mark_paid` uç noktası yoktur. |
| Bir taslağı silme | Yerel bir `DELETE /invoices/{id}` yoktur. Geçersiz kılma, fatura kaydını ve numarasını korur. |
| `plan.payment_method_configuration` | Fatura isteği bu alanı kabul etmez. Bunun yerine mevcut varyantın veya hesabın ödeme yöntemlerini yapılandırın. |
| Yinelenen planlarda ücretsiz denemeler ve başlangıç ücretleri | `2026-11-11` sürümünden itibaren fatura başlangıç ücretini ekler. Önceki sürümler yenileme fiyatını faturalandırır; bu nedenle ücreti tek seferlik bir kalem olarak ekleyin. Varyantın deneme süresi uygulanır. |
| `subscription_billing_anchor_at` | Faturada `subscription_starts_at` gönderin. Fatura ödendiğinde geçmişte kalmış bir zaman, dönemi ödeme anında başlatır. Önceden olduğu gibi ücretsiz denemeyi atlar. |
| Rastgele `line_items` etiketleri, kesirli miktarlar veya negatif alacaklar | Yerel satırlar varyantları faturalandırır. Miktarlar pozitif tam sayı olmalıdır ve etiketler ürün veya varyant başlıklarından gelir. Dökümü kopyalamak yerine ücretleri yeniden oluşturun. |
| Eski faturanın `current_plan.id` değerini yeniden kullanma | Yerel faturalar eski faturalara bağlı varyantları reddeder. Ayrı bir varyant kullanın veya satır içinde bir tane oluşturun. |

## Oluşturma isteğini eşleyin

Eski bir oluşturma isteği tek bir plan ve isteğe bağlı olarak fiyatını bölen etiketler gönderir. Yerel bir oluşturma isteği, faturalandırılan her varyant için bir kalem gönderir.

Bu örnekler toplam 19.99 USD kalem fiyatı belirler. Mevcut yerel varyant 15 USD'lik kurulum ücretini temsil eder. 4.99 USD'lik hizmet bedeli, ürünü olmayan özel bir tek seferlik ücrettir. Her iki API de fiyatları para birimi cinsinden kabul eder. 4.99 USD için `4.99` kullanın. `499` göndermek 499 USD faturalandırır.

```json Legacy theme={null}
{
	"account_id": "biz_xxxxxxxxxxxxxx",
	"product_id": "prod_xxxxxxxxxxxxx",
	"member_id": "mber_xxxxxxxxxxxxx",
	"collection_method": "send_invoice",
	"due_date": "2026-12-01T00:00:00Z",
	"plan": {
		"plan_type": "one_time",
		"initial_price": 19.99,
		"currency": "usd"
	},
	"line_items": [
		{ "label": "Setup", "quantity": 1, "unit_price": 15 },
		{ "label": "Service fee", "quantity": 1, "unit_price": 4.99 }
	]
}
```

```json Native theme={null}
{
	"account_id": "biz_xxxxxxxxxxxxxx",
	"member_id": "mber_xxxxxxxxxxxxx",
	"due_at": "2026-12-01T00:00:00Z",
	"items": [
		{ "variant_id": "plan_xxxxxxxxxxxxx", "quantity": 1 },
		{
			"variant": {
				"title": "Service fee",
				"billing_type": "one_time",
				"initial_price": 4.99,
				"currency": "usd"
			}
		}
	]
}
```

Yerel istek bir taslak oluşturur. Düzenlemek ve e-postayla göndermek için `POST /invoices/{id}/send` ile gönderin. `member_id` bir aboneliği (`mem_`) değil, bir müşteriyi (`mber_`) tanımlar.

| Eski alan | Yerel alan | Notlar |
| - | - | - |
| `account_id` | `account_id` | Faturayı düzenleyen hesap. |
| `plan` | `items` | Her kalem `variant_id` veya satır içi `variant` ile isteğe bağlı bir `quantity` alır. Tüm kalemler aynı para birimini kullanır. |
| `product`, `product_id` | `items[].variant.product`, `items[].variant.product_id` | İkisinden birini kullanın. Satır içi `product`, `external_identifier` ve `title` gerektirir. Yinelenen bir varyantın bir ürüne ihtiyacı vardır. Tek seferlik özel bir ücret bunu atlayabilir. |
| `line_items` | `items` | Faturalandırılan satırları varyant olarak yeniden oluşturun. `quantity` varsayılan olarak 1'dir. 1'in üzerindeki değerler, birden fazla miktara izin veren bir varyant gerektirir. |
| `collection_method` | `payment_method_id`, ardından düzenleme veya gönderme | Otomatik ücretlendirme için kayıtlı bir yöntem ayarlayın veya ödeme sayfası üzerinden ödeme için bunu atlayın. Bkz. [Düzenleme, gönderme ve ücretlendirme](#issue-send-and-charge). |
| `save_as_draft` | Yok | Oluşturma her zaman taslak olarak kaydeder. |
| `automatically_finalizes_at` | Send Invoice üzerinde `send_at` | Düzenlemeyi planlanan gönderime kadar erteler. `charge_at` düzenlemeyi değil, kayıtlı yöntemle ücretlendirmeyi erteler. |
| `due_date` | `due_at` | Bir ISO 8601 zaman damgası gönderin. |
| `charge_buyer_fee` | `buyer_fee_percentage` | `false` değerini `0` ile, eski `true` ücretini `5` ile eşleyin. Sıfır olmayan diğer yüzdeler 5 ile 100 arasında olmalı ve en fazla iki ondalık basamak içermelidir. |
| `payment_method_id`, `payment_token_id` | `payment_method_id` | Müşterinin `payt_` önekli kayıtlı ödeme yöntemlerinden biri. Ayarlamak için `payment:charge` gerekir. |
| `member_id`, `email_address`, `customer_name` | Oluşturmada aynı | `member_id` veya `email_address` seçin, ikisini birden değil. Yerel faturalar ayrıca faturalandırılan müşteriden bağımsız olarak `recipient_emails` alır. |
| `mailing_address_id`, `billing_address` | Aynı adlar, daha dar adres girdisi | Birini seçin. Satır içi bir adres `line1`, `city`, `postal_code` ve `country` gerektirir. Ayrıca `name`, `line2`, `state` ve `phone` kabul eder. Eski `tax_id_type` veya `tax_id_value` alanlarını kabul etmez. |
| `subscription_billing_anchor_at` | `subscription_starts_at` | İlk faturalandırma döneminin başladığı zaman. Gelecekte olmalı ve yinelenen bir kalem gerektirir. |
| Yok | `memo`, `metadata` | `memo` e-postada, PDF'te ve ödeme sayfasında görünür. `metadata` dize anahtar-değer çiftlerini saklar. |

`2026-10-27-2` öncesindeki yerel sürümler için `variant_id`, `variant` ve `billing_type` yerine `plan_id`, `plan` ve `plan_type` kullanın. Bu eski sürümlerde yanıtın satır kalemleri de `plan_id` kullanır.

### Düzenlenmiş tutarları kilitli tutun

`PATCH /invoices/{id}` bir taslağın kalemlerini ve faturalandırma ayrıntılarını düzenler. `items` göndermek, varyantların güncel fiyatlarını kullanarak listenin tamamını değiştirir. Atlanması, kaydedilmiş kalemleri ve fiyatları korur.

* Kalemleri veya faturalandırma ayrıntılarını düzenlemeden önce planlanmış bir gönderimi iptal edin.
* `2026-11-02-1` sürümünden itibaren bir taslağa atanmış müşteriyi değiştiremez veya temizleyemezsiniz. Müşterisi olmayan bir taslağa yine de müşteri atanabilir. Başka biri için yeni bir fatura oluşturmadan önce taslağı geçersiz kılın.
* `email_address` ve `customer_name` yalnızca oluşturma sırasında kullanılan girdilerdir.
* Düzenlenmiş tutarlar ve kalemler kilitlidir. Yalnızca `memo` ve/veya `recipient_emails` içeren bir güncellemeye, planlanmış bir taslak dahil `draft`, `open` ve `uncollectible` faturalarda izin verilir.

## Düzenleme, gönderme ve ücretlendirme

Eski bir oluşturma isteği tahsilat davranışını `collection_method` ile seçer. Yerel faturalar, taslağı oluşturduktan sonra ayrı çağrılar kullanır:

1. Nihai vergiyi hesaplamak ve ilk fatura e-postasını göndermeden ödemeye açmak için `POST /invoices/{id}/issue` ile **düzenleyin**.
2. **Veya** `POST /invoices/{id}/send` ile **gönderin**. Bu, taslağı düzenler. Kayıtlı bir yöntemi hemen ücretlendirmediği sürece alıcılara e-posta gönderir. `open` bir faturayı göndermek onu yeniden e-postayla gönderir. `send_at` bir taslağın gönderimini planlar. `POST /invoices/{id}/unschedule` bu planı iptal eder.
3. Taslakta `payment_method_id` ayarlayarak **kayıtlı bir yöntemi ücretlendirin**. Pozitif bir toplam için düzenleme veya gönderme, gelecekteki bir `charge_at` zamanında, yoksa gelecekteki bir `due_at` zamanında, o da yoksa hemen ücretlendirir. `charge_at` gelecekte olmalıdır ve `send_at` öncesinde olamaz.

Hemen ücretlendiren bir taslağı göndermek ilk fatura e-postasını atlar. Daha sonra ücretlendirecek şekilde göndermek e-postayı şimdi gönderir. Başarısız bir otomatik ücretlendirme, Issue Invoice kullanmış olsanız bile bir ödeme bağlantısı e-postasını tetikleyebilir. [Kayıtlı bir ödeme yöntemini ücretlendirin](https://docs.whop.com/tr/developer/guides/invoices.md#charge-a-saved-payment-method) akışı açıklar.

`open` yanıtı ödemeyi onaylamaz. Siparişi tamamlamadan önce `payment.succeeded` olayını bekleyin. Açık bir faturayı ücretlendirmek veya yeniden denemek için [Charge Invoice](https://docs.whop.com/tr/api-reference/invoices/charge-invoice.md) kullanın. Faturayı yeniden düzenlemek veya göndermek başka bir ücretlendirme başlatmaz.

Yinelenen bir varyant için Issue Invoice veya Send Invoice üzerindeki `collection_method` **yenilemeleri** kontrol eder. `charge_automatically` gelecekteki ödemeleri otomatik olarak tahsil eder. `send_invoice` her dönem yeni bir fatura oluşturur ve e-postayla gönderir. İlk faturanın tahsilatı için `payment_method_id` yerine geçmez. Bkz. [Bir aboneliği faturalandırın](https://docs.whop.com/tr/developer/guides/invoices.md#invoice-a-subscription).

## Yanıtı eşleyin

| Eski alan | Yerel alan | Notlar |
| - | - | - |
| `id` (`inv_`) | `id` (`pay_`) | `object` değeri `invoice` olur. Aynı kimlik ödemeyi de tanımlar. |
| `current_plan` fiyatı | `subtotal`, `buyer_fee_amount`, `tax_amount`, `total`, `amount_due` | Para nesneleri ondalık dize biçiminde `amount`, `currency`, `decimals` ve `display_decimals` içerir. `totals_status` taslakta `estimated`, diğer durumlarda `final` olur. |
| `company.id` | `account_id` | Hesabı kimliğe göre getirin. |
| `product.id`, `current_plan.id` | `line_items[].product_id`, `line_items[].variant_id` | Faturalandırılan her satır kendi ürününü ve varyantını tanımlar. Özel bir ücretin ürünü olmayabilir. |
| `member.id` | `member_id` | `mber_` önekli müşteri kimliği. `member:basic:read` gerektirir. |
| `user` | Üst düzey kullanıcı alanı yok | Kullanıcısını bulmak için üyeyi getirin. `membership_id` (`mem_`) müşteriyi değil, bir üyeliği tanımlar. |
| `mailing_address` | `billing_address`, `mailing_address_id` | Satır içi adres bir nesne olarak kalır. |
| `payment.id` | Faturanın kendi `id` değeri | Aynı `pay_` kimliğini kullanarak ödeme ayrıntılarını `GET /payments/{id}` ile getirin. |
| `number` | `number`, `invoice_prefix` | Biçimlendirilmiş numara ve hesap öneki. |
| `due_date` | `due_at` | ISO 8601 zaman damgası veya `null`. |
| `automatically_finalizes_at` | `scheduled_send_at` | `scheduled_charge_at` planlanmış bir kayıtlı yöntem ücretlendirmesini gösterir. `scheduled_collection_method` planlanmış bir gönderim için yenileme tahsilat seçimini gösterir. |
| `charge_buyer_fee` | `buyer_fee_percentage`, `buyer_fee_amount` | Yüzde ve hesaplanan tutarı. |
| `customer_name`, `email_address` | Aynı | Ayrıca `recipient_emails`. Bu alanlar izne tabidir. |
| `pay_online_url` | `checkout_link` | Bir URL değil, imzalı bir token. Bkz. [Fatura ödeme sayfasını açın](#open-the-invoice-checkout). |
| `line_items` | `line_items` | Satırlar `variant_id`, `product_id`, `label`, `description`, `quantity`, `unit_amount`, `subtotal`, `discount_amount` ve `tax_amount` içerir. |
| `status` | `status`, `overdue` | Bkz. [Durumları eşleyin](#map-statuses). |
| `payment_processing` | `status` ve ödeme ayrıntıları | Ödeme sonuçlanırken `pending` durumunu ele alın. `paid_at` ödemenin tamamlanmasını kaydeder. Bir işleme bayrağı değildir. |
| `fetch_invoice_token` | Doğrudan karşılığı yok | Kimliği doğrulanmış fatura okumalarını, ödeme sayfası için `checkout_link` ve PDF için Generate Invoice PDF kullanın. |
| Yok | `paid_at`, `memo`, `metadata` | Ödemenin tamamlanma zamanı, müşteri notu ve meta verileriniz. |

Bir PDF indirmek için kısa ömürlü bir bağlantı almak üzere `POST /invoices/{id}/generate_pdf` çağırın.

### Fatura ödeme sayfasını açın

`checkout_link`, bir `.` ile ayrılmış fatura kimliğini ve imzalı bir token'ı içerir. Bu fatura için bir oturum açmak üzere değerin tamamını `link` olarak `POST /checkout_sessions` uç noktasına iletin. Müşteriye yönelik bir URL için [Barındırılan ödeme sayfası URL'sini oluşturun](https://docs.whop.com/tr/developer/guides/invoices.md#get-the-checkout-link) adımlarını izleyin.

Alan yalnızca ödeme sayfası kullanılabilir olduğunda bulunur: fatura `open` olmalıdır. Kurumsal alıcılar ve iptal edilmiş üyelikler bu ödeme sayfasını kullanamaz. Anahtarınızın `payment:charge` iznine veya faturada kayıtlı bir ödeme yöntemi yoksa `invoice:create`/`invoice:update` iznine ihtiyacı vardır. Taslak, ödenmiş, geçersiz kılınmış veya tahsil edilemez bir faturada ve kurumsal alıcılar için `null` olur.

## Durumları eşleyin

| Eski `status` | Yerel |
| - | - |
| `draft` | `draft` |
| `open` | `open` |
| `past_due` | `overdue: true` ile `open` veya `uncollectible` |
| `paid` | `paid` |
| `uncollectible` | `uncollectible` |
| `void` | `void` |

Yerel faturalar ayrıca `authorized`, `pending` veya `unresolved` döndürebilir. Eski enum dışındaki her durumu ödenmiş veya başarısız olarak değerlendirmeyin. [Durumlar ve yaşam döngüsü](https://docs.whop.com/tr/developer/guides/invoices.md#statuses-and-lifecycle) bunları açıklar.

## Uç noktaları eşleyin

| Eski | Yerel |
| - | - |
| `GET /invoices` | [List Invoices](https://docs.whop.com/tr/api-reference/invoices/list-invoices.md), `overdue` filtresiyle |
| `GET /invoices/{id}` | [Retrieve Invoice](https://docs.whop.com/tr/api-reference/invoices/retrieve-invoice.md) |
| `POST /invoices` | [Create Invoice](https://docs.whop.com/tr/api-reference/invoices/create-invoice.md), taslak olarak kaydeder |
| `PATCH /invoices/{id}` | [Update Invoice](https://docs.whop.com/tr/api-reference/invoices/update-invoice.md), yukarıdaki taslak ve düzenlenmiş fatura kurallarına tabidir |
| `POST /invoices/{id}/resend` | [Send Invoice](https://docs.whop.com/tr/api-reference/invoices/send-invoice.md) |
| `POST /invoices/{id}/void` | [Void Invoice](https://docs.whop.com/tr/api-reference/invoices/void-invoice.md) |
| `POST /invoices/{id}/mark_uncollectible` | [Mark an invoice uncollectible](https://docs.whop.com/tr/api-reference/invoices/mark-invoice-uncollectible.md) |
| `DELETE /invoices/{id}` | Karşılığı yok. Kaydını koruyarak iptal etmek için taslağı geçersiz kılın. |
| `POST /invoices/{id}/mark_paid` | Karşılığı yok |
| Yok | [Issue Invoice](https://docs.whop.com/tr/api-reference/invoices/issue-invoice.md), [Cancel Scheduled Send](https://docs.whop.com/tr/api-reference/invoices/cancel-scheduled-send.md), [Charge Invoice](https://docs.whop.com/tr/api-reference/invoices/charge-invoice.md), [List Invoice Sends](https://docs.whop.com/tr/api-reference/invoices/list-invoice-sends.md), [Generate Invoice PDF](https://docs.whop.com/tr/api-reference/invoices/generate-invoice-pdf.md) |

## Webhook'ları eşleyin

Yerel faturalar `pay_` kimlikleri için ödeme olayları gönderir. `invoice.*` olayları eski faturaları tanımlar.

| Eski olay | Yerel davranış |
| - | - |
| `invoice.created` | Taslak oluşturulduğunda değil, düzenlendiğinde `payment.created` |
| `invoice.paid` | `payment.succeeded` |
| `invoice.past_due` | `overdue` değerini okuyun veya buna göre filtreleyin. Eşleşen bir vadesi geçmiş ödeme olayı yoktur. |
| `invoice.voided`, `invoice.marked_uncollectible` | Faturanın `status` değerini okuyun. Bu geçişler için doğrudan bir ödeme olayı karşılığı yoktur. |

Ödeme olayları faturalarla ilgisi olmayan ödemeleri de kapsar. Olayın ödeme kimliğini sakladığınız yerel fatura kimlikleriyle eşleştirin. [Webhook'lar](https://docs.whop.com/tr/developer/guides/invoices.md#webhooks), `payment.succeeded` üzerinden siparişin nasıl tamamlanacağını gösterir.

## İzinler

| İşlem | Gereken izin |
| - | - |
| Kayıtlı ödeme yöntemi olmadan taslak oluşturma | `invoice:create` veya `payment:charge` |
| Kayıtlı ödeme yöntemi veya planlanmış gönderimi olmayan bir taslağı güncelleme | `invoice:update`, `invoice:create` veya `payment:charge` |
| Kayıtlı ödeme yöntemi olmayan bir taslağı gönderme veya planlama ya da planlanmış gönderimini iptal etme | `invoice:update`, `invoice:create` veya `payment:charge` |
| Kayıtlı bir ödeme yöntemi ayarlama, kayıtlı ödeme yöntemi olan bir faturaya yazma, düzenleme, ücretlendirme, geçersiz kılma veya tahsil edilemez olarak işaretleme | `payment:charge` |
| Planlanmış bir taslağı güncelleme veya düzenlenmiş bir faturayı güncelleme ya da yeniden gönderme | `payment:charge` |
| Listeleme, getirme, PDF oluşturma veya e-posta gönderimlerini listeleme | `payment:basic:read` |
| Satır içi bir `variant` sağlama | Ayrıca `plan:create` |
| Satır içi bir `product` oluşturma veya güncelleme | Ayrıca sırasıyla `access_pass:create` veya `access_pass:update` |

`member:basic:read` müşteri adlarını ve üye/üyelik kimliklerini gösterir. `member:email:read`, `email_address` ve `recipient_emails` alanlarını gösterir. Ödeme yöntemi ve adres alanları `payment:basic:read` gerektirir.

## Geçiş kontrol listesi

1. Eski API'de kalması gereken iş akışları için [Geçişten önce](#before-you-migrate) bölümünü kontrol edin.
2. Yerel çağrıları alan adlarıyla eşleşen yayınlanmış bir sürüme sabitleyin; örneğin bu örnekler için `2026-11-02-1`.
3. Miktarları, fiyatları, para birimini ve ürün gereksinimlerini kontrol ederek uygun varyantlardan `items` oluşturun.
4. Eski tek çağrılık oluşturmayı, oluşturma ve ardından düzenleme veya gönderme ile değiştirin. İlk fatura için kayıtlı yöntemle ücretlendirmeyi, yenilemeler için bir tahsilat yöntemini seçin.
5. Son ödeme tarihlerini, planlanmış gönderimleri ve alıcı ücretlerini yalnızca alan adlarına göre değil, davranışlarına göre eşleyin.
6. Yerel `pay_` ve eski `inv_` kimliklerini ayrı tutun. Eski okumaları önceki sürümde tutun.
7. Tutarları para nesnelerinden okuyun ve ödeme sayfasını imzalı `checkout_link` ile açın.
8. `overdue` ve ek ödeme durumlarını ele alın.
9. Siparişi faturanın ödeme kimliği için `payment.succeeded` üzerinden tamamlayın.
10. Satır içi varyant/ürün ve müşteri okuma izinleri dahil olmak üzere akışınızın kullandığı izinleri verin.

## Sonraki adımlar

> [card] [Faturalar kılavuzu](https://docs.whop.com/tr/developer/guides/invoices.md)
>
> Yerel faturaları oluşturun, düzenleyin, gönderin ve tahsil edin.

> [card] [Faturalar API referansı](https://docs.whop.com/tr/api-reference/invoices/create-invoice.md)
>
> Her yerel fatura uç noktası ve alanı.

> [card] [Eski fatura API'si](https://docs.whop.com/tr/api-reference/legacy/invoices/legacy-invoice.md)
>
> Mevcut entegrasyonunuzun çağırdığı uç noktalar.

> [card] [API sürümleri](https://docs.whop.com/tr/developer/api/versioning.md)
>
> `Api-Version-Date` ve sürüm sabitlemelerinin nasıl çalıştığı.


## Related topics

- [Önceki sürümlerden geçiş yapın](https://docs.whop.com/tr/developer/api/migrate-from-previous-versions.md)
- [Eski Fatura](https://docs.whop.com/tr/api-reference/legacy/invoices/legacy-invoice.md)
- [Öğe Oturumları (Eski)](https://docs.whop.com/tr/sdk/elements/overview.md)
