# Tahsil Developers

> Tahsil kullanıcı API dokümantasyonu

## Docs

- [Bank connector log detail](https://tahsil.dev/api-reference/audit--connector-logs/bank-connector-log-detail.md): Default read scope includes all authorized companies when no company header is provided.
- [List bank connector request logs](https://tahsil.dev/api-reference/audit--connector-logs/list-bank-connector-request-logs.md): Default read scope includes all authorized companies when no company header is provided.
- [Bank account connector detail](https://tahsil.dev/api-reference/banking--accounts/bank-account-connector-detail.md): Default read scope includes all authorized companies when no company header is provided.
- [Discover and persist provider sub-accounts](https://tahsil.dev/api-reference/banking--accounts/discover-and-persist-provider-sub-accounts.md): Decrypts credentials only in memory and records a redacted provider audit event.
- [List bank connections with provider-owned sub-accounts](https://tahsil.dev/api-reference/banking--accounts/list-bank-connections-with-provider-owned-sub-accounts.md): Default read scope includes all authorized companies when no company header is provided.
- [List normalized provider connection field metadata](https://tahsil.dev/api-reference/banking--accounts/list-normalized-provider-connection-field-metadata.md): Returns field definitions only; provider credential values are never returned. Date fields are transaction query controls, not stored credentials.
- [Read encrypted provider credential status](https://tahsil.dev/api-reference/banking--accounts/read-encrypted-provider-credential-status.md): Returns encryption metadata only; provider secrets are never returned.
- [Read normalized provider connection field metadata for a bank](https://tahsil.dev/api-reference/banking--accounts/read-normalized-provider-connection-field-metadata-for-a-bank.md): Requires a tenant admin or operator Bearer token and proxies metadata through Core without exposing the provider envelope.
- [Register a bank connection for the tenant](https://tahsil.dev/api-reference/banking--accounts/register-a-bank-connection-for-the-tenant.md): A tenant can register multiple independent connections for the same bank. Currency and physical accounts are discovered by provider setup and returned as subAccounts. Demo and production connections keep separate credential modes.
- [Remove bank account connector](https://tahsil.dev/api-reference/banking--accounts/remove-bank-account-connector.md): Removes the connection, encrypted credential and query schedule. Previously ingested transactions and retained provider audit logs remain available as financial history.
- [Remove encrypted provider credentials](https://tahsil.dev/api-reference/banking--accounts/remove-encrypted-provider-credentials.md): Requires a tenant admin or operator Bearer token.
- [Return sanitized connector setup, sync, schedule and last-attempt health](https://tahsil.dev/api-reference/banking--accounts/return-sanitized-connector-setup-sync-schedule-and-last-attempt-health.md)
- [Return tenant subscription usage and remaining limits](https://tahsil.dev/api-reference/banking--accounts/return-tenant-subscription-usage-and-remaining-limits.md): Requires x-company-id. Optional bankCode adds the bank-specific transaction metric.
- [Run an idempotent manual provider transaction sync](https://tahsil.dev/api-reference/banking--accounts/run-an-idempotent-manual-provider-transaction-sync.md): Requires a tenant admin or operator Bearer token and deduplicates by tenant, bank and provider stamp.
- [Store or rotate encrypted provider credentials](https://tahsil.dev/api-reference/banking--accounts/store-or-rotate-encrypted-provider-credentials.md): Requires a tenant admin or operator Bearer token.
- [Update bank account connector](https://tahsil.dev/api-reference/banking--accounts/update-bank-account-connector.md)
- [Add or reactivate a protected manual assignment](https://tahsil.dev/api-reference/banking--automation/add-or-reactivate-a-protected-manual-assignment.md)
- [Archive a rule without changing existing assignments](https://tahsil.dev/api-reference/banking--automation/archive-a-rule-without-changing-existing-assignments.md)
- [Cancel a pending or running rule run](https://tahsil.dev/api-reference/banking--automation/cancel-a-pending-or-running-rule-run.md)
- [Create a transaction rule](https://tahsil.dev/api-reference/banking--automation/create-a-transaction-rule.md)
- [Delete a manual assignment](https://tahsil.dev/api-reference/banking--automation/delete-a-manual-assignment.md)
- [Get rule run progress](https://tahsil.dev/api-reference/banking--automation/get-rule-run-progress.md)
- [Get transaction rule detail](https://tahsil.dev/api-reference/banking--automation/get-transaction-rule-detail.md)
- [List manual and automatic transaction assignments](https://tahsil.dev/api-reference/banking--automation/list-manual-and-automatic-transaction-assignments.md)
- [List preview and backfill runs](https://tahsil.dev/api-reference/banking--automation/list-preview-and-backfill-runs.md)
- [List tenant transaction rules](https://tahsil.dev/api-reference/banking--automation/list-tenant-transaction-rules.md)
- [Pause future rule evaluation](https://tahsil.dev/api-reference/banking--automation/pause-future-rule-evaluation.md)
- [Queue a backfill from a completed current preview](https://tahsil.dev/api-reference/banking--automation/queue-a-backfill-from-a-completed-current-preview.md)
- [Queue a read-only historical rule preview](https://tahsil.dev/api-reference/banking--automation/queue-a-read-only-historical-rule-preview.md)
- [Resume future rule evaluation](https://tahsil.dev/api-reference/banking--automation/resume-future-rule-evaluation.md)
- [Retry a failed rule run](https://tahsil.dev/api-reference/banking--automation/retry-a-failed-rule-run.md)
- [Retry dead or failed transaction automation](https://tahsil.dev/api-reference/banking--automation/retry-dead-or-failed-transaction-automation.md)
- [Update a manual assignment](https://tahsil.dev/api-reference/banking--automation/update-a-manual-assignment.md)
- [Update a rule using optimistic version locking](https://tahsil.dev/api-reference/banking--automation/update-a-rule-using-optimistic-version-locking.md)
- [Execute flexible dashboard widget query](https://tahsil.dev/api-reference/banking--dashboard/execute-flexible-dashboard-widget-query.md): Default read scope includes all authorized companies when no company header is provided.
- [Return allowed dashboard DSL catalog](https://tahsil.dev/api-reference/banking--dashboard/return-allowed-dashboard-dsl-catalog.md): Default read scope includes all authorized companies when no company header is provided.
- [Create connector polling schedule](https://tahsil.dev/api-reference/banking--polling/create-connector-polling-schedule.md): Derives bankCode from the tenant-owned account and initializes nextRunAt.
- [Delete polling schedule](https://tahsil.dev/api-reference/banking--polling/delete-polling-schedule.md)
- [List connector polling schedules](https://tahsil.dev/api-reference/banking--polling/list-connector-polling-schedules.md): Default read scope includes all authorized companies when no company header is provided.
- [Pause polling schedule](https://tahsil.dev/api-reference/banking--polling/pause-polling-schedule.md): Cancels the active schedule lease; an in-flight provider result remains idempotent.
- [Polling schedule detail](https://tahsil.dev/api-reference/banking--polling/polling-schedule-detail.md): Default read scope includes all authorized companies when no company header is provided.
- [Resume polling schedule](https://tahsil.dev/api-reference/banking--polling/resume-polling-schedule.md): Recalculates nextRunAt from the schedule timezone and timing rules.
- [Update polling schedule](https://tahsil.dev/api-reference/banking--polling/update-polling-schedule.md)
- [Delete transaction record](https://tahsil.dev/api-reference/banking--transactions/delete-transaction-record.md)
- [Export the filtered tenant transaction set as CSV](https://tahsil.dev/api-reference/banking--transactions/export-the-filtered-tenant-transaction-set-as-csv.md): Uses the same allowlisted filters as the list endpoint and applies a configured row cap.
- [Ingest bank transaction record](https://tahsil.dev/api-reference/banking--transactions/ingest-bank-transaction-record.md)
- [List ingested bank transactions](https://tahsil.dev/api-reference/banking--transactions/list-ingested-bank-transactions.md): Default read scope includes all authorized companies when no company header is provided.
- [Transaction detail](https://tahsil.dev/api-reference/banking--transactions/transaction-detail.md): Default read scope includes all authorized companies when no company header is provided.
- [Update transaction metadata](https://tahsil.dev/api-reference/banking--transactions/update-transaction-metadata.md)
- [Authenticate user and issue token pair](https://tahsil.dev/api-reference/identity--auth/authenticate-user-and-issue-token-pair.md)
- [Change the authenticated user password and revoke refresh sessions](https://tahsil.dev/api-reference/identity--auth/change-the-authenticated-user-password-and-revoke-refresh-sessions.md)
- [Hydrate the authenticated user and company memberships](https://tahsil.dev/api-reference/identity--auth/hydrate-the-authenticated-user-and-company-memberships.md)
- [Revoke refresh token session](https://tahsil.dev/api-reference/identity--auth/revoke-refresh-token-session.md): Accepts refreshToken in the body or revokes and clears the HttpOnly refresh cookie.
- [Rotate refresh token and issue new access token](https://tahsil.dev/api-reference/identity--auth/rotate-refresh-token-and-issue-new-access-token.md): Accepts refreshToken in the body for non-browser clients or the HttpOnly refresh cookie for web clients.
- [Update the authenticated user profile and access policy](https://tahsil.dev/api-reference/identity--auth/update-the-authenticated-user-profile-and-access-policy.md)
- [Dependency readiness probe](https://tahsil.dev/api-reference/operations--health/dependency-readiness-probe.md)
- [Process liveness probe](https://tahsil.dev/api-reference/operations--health/process-liveness-probe.md)
- [Cancel an unsettled payment](https://tahsil.dev/api-reference/payments--orchestration/cancel-an-unsettled-payment.md)
- [Create a draft rate plan](https://tahsil.dev/api-reference/payments--orchestration/create-a-draft-rate-plan.md)
- [Create a full or partial refund](https://tahsil.dev/api-reference/payments--orchestration/create-a-full-or-partial-refund.md)
- [Create a single-use payment session](https://tahsil.dev/api-reference/payments--orchestration/create-a-single-use-payment-session.md)
- [Create a Virtual POS connection](https://tahsil.dev/api-reference/payments--orchestration/create-a-virtual-pos-connection.md)
- [Delete a Virtual POS connection](https://tahsil.dev/api-reference/payments--orchestration/delete-a-virtual-pos-connection.md)
- [Delete Virtual POS credentials](https://tahsil.dev/api-reference/payments--orchestration/delete-virtual-pos-credentials.md)
- [Encrypt and replace Virtual POS credentials](https://tahsil.dev/api-reference/payments--orchestration/encrypt-and-replace-virtual-pos-credentials.md)
- [Get a Virtual POS connection](https://tahsil.dev/api-reference/payments--orchestration/get-a-virtual-pos-connection.md)
- [Get canonical payment status](https://tahsil.dev/api-reference/payments--orchestration/get-canonical-payment-status.md)
- [Get credential metadata without secret values](https://tahsil.dev/api-reference/payments--orchestration/get-credential-metadata-without-secret-values.md)
- [Get tenant payment settings](https://tahsil.dev/api-reference/payments--orchestration/get-tenant-payment-settings.md)
- [Get Virtual POS and successful payment plan usage](https://tahsil.dev/api-reference/payments--orchestration/get-virtual-pos-and-successful-payment-plan-usage.md)
- [List enabled payment providers](https://tahsil.dev/api-reference/payments--orchestration/list-enabled-payment-providers.md)
- [List payment intents](https://tahsil.dev/api-reference/payments--orchestration/list-payment-intents.md)
- [List rate plan versions](https://tahsil.dev/api-reference/payments--orchestration/list-rate-plan-versions.md)
- [List supported card families](https://tahsil.dev/api-reference/payments--orchestration/list-supported-card-families.md)
- [List tenant Virtual POS connections](https://tahsil.dev/api-reference/payments--orchestration/list-tenant-virtual-pos-connections.md)
- [Publish and atomically activate a rate plan](https://tahsil.dev/api-reference/payments--orchestration/publish-and-atomically-activate-a-rate-plan.md)
- [Rotate and return the tenant webhook secret once](https://tahsil.dev/api-reference/payments--orchestration/rotate-and-return-the-tenant-webhook-secret-once.md)
- [Test and activate a configured Virtual POS](https://tahsil.dev/api-reference/payments--orchestration/test-and-activate-a-configured-virtual-pos.md)
- [Update a Virtual POS connection](https://tahsil.dev/api-reference/payments--orchestration/update-a-virtual-pos-connection.md)
- [Update allowed origins, webhook and routing settings](https://tahsil.dev/api-reference/payments--orchestration/update-allowed-origins-webhook-and-routing-settings.md)
- [Update draft rate rows](https://tahsil.dev/api-reference/payments--orchestration/update-draft-rate-rows.md)
- [Firma kapsamı](https://tahsil.dev/baslangic/firma-kapsami.md): x-company-id ve x-company-ids header kuralları.
- [5 dakikada başlayın](https://tahsil.dev/baslangic/hizli-baslangic.md): Tahsil kullanıcı API'si ile ilk güvenli isteğinizi gönderin.
- [Kimlik doğrulama](https://tahsil.dev/baslangic/kimlik-dogrulama.md): Müşteri API'sinde Bearer access token kullanımını güvenli biçimde uygulayın.
- [Değişiklikler](https://tahsil.dev/degisiklikler.md): Tahsil kullanıcı API'si ve developer portalı yayın notları.
- [Tahsil API](https://tahsil.dev/index.md): Banka verisini ve sanal POS ödeme orkestrasyonunu tek, güvenli platformda yönetin.
- [Hata kodları](https://tahsil.dev/referans/hata-kodlari.md): HTTP durumları ve kararlı makine hata kodları.
- [Sürümleme ve geriye uyumluluk](https://tahsil.dev/referans/surumleme.md): Tahsil kullanıcı API'si v1 uyumluluk politikası.
- [Abonelik ve kullanım limitleri](https://tahsil.dev/rehberler/abonelik-ve-limitler.md): Ürün, plan, entitlement ve kullanım sınırlarını okuyun.
- [Connector logları](https://tahsil.dev/rehberler/connector-loglari.md): Redact edilmiş banka bağlantısı audit kayıtlarını inceleyin.
- [Dashboard sorguları](https://tahsil.dev/rehberler/dashboard.md): Allowlist tabanlı finansal analiz DSL'i.
- [Kullanıcı erişim politikaları](https://tahsil.dev/rehberler/erisim-politikalari.md): Kullanıcı IP ve zaman aralığı güvenlik politikaları.
- [Firma ve üyelik kapsamı](https://tahsil.dev/rehberler/firma-ve-ekip.md): Aktif firma, üyelikler ve rol sınırları.
- [Banka hareketleri](https://tahsil.dev/rehberler/hareketler.md): Hareket listeleme, detay, filtreler ve güvenli dışa aktarma.
- [Hesaplar ve senkronizasyon](https://tahsil.dev/rehberler/hesaplar-ve-senkronizasyon.md): Banka bağlantısı, credential durumu, setup ve manuel sync akışı.
- [Belirsiz işlemler ve durum mutabakatı](https://tahsil.dev/rehberler/odemeler/belirsiz-islemler.md): Timeout veya eksik callback sonrasında çift tahsilat oluşturmadan ödeme sonucunu çözümleyin.
- [Ödeme durumları ve idempotency](https://tahsil.dev/rehberler/odemeler/durumlar-ve-idempotency.md): Payment intent durumlarını, geçişlerini ve tekrar eden isteklerde güvenli davranışı uygulayın.
- [Hatalar ve güvenli retry](https://tahsil.dev/rehberler/odemeler/hatalar-ve-retry.md): Validation, ret, teknik hata ve belirsiz sonuç gruplarına doğru merchant davranışını bağlayın.
- [İptal ve iade](https://tahsil.dev/rehberler/odemeler/iptal-ve-iade.md): Settlement öncesi iptal ile başarılı işlemde tam veya kısmi iade arasındaki farkı yönetin.
- [Kart ailesi, BIN ve taksit](https://tahsil.dev/rehberler/odemeler/kart-bin-ve-taksit.md): Kart kuruluşu, kart ailesi ve ilk sekiz hane üzerinden uygun taksit seçeneklerinin nasıl bulunduğunu anlayın.
- [Limitler ve operasyonel izleme](https://tahsil.dev/rehberler/odemeler/limitler-ve-operasyon.md): Sanal POS ve başarılı ödeme kotalarını, sağlık durumunu ve production kontrollerini izleyin.
- [Mimari ve güven sınırı](https://tahsil.dev/rehberler/odemeler/mimari-ve-guvenlik.md): Merchant backend, tarayıcı, Tahsil Core API ve kart işleme katmanı arasındaki veri sınırlarını anlayın.
- [Ödeme oturumu entegrasyonu](https://tahsil.dev/rehberler/odemeler/odeme-oturumu.md): Merchant backend ile frontend arasındaki payment intent ve tek kullanımlık clientSecret akışını kurun.
- [Oran planları ve fiyatlama](https://tahsil.dev/rehberler/odemeler/oran-planlari.md): Tek çekim, taksit, kart eşleşmesi, müşteri oranı ve işletme maliyetini sürümlü olarak yönetin.
- [Routing ve failover](https://tahsil.dev/rehberler/odemeler/routing-ve-failover.md): Uygun POS adaylarının maliyet, öncelik ve hata sınıfına göre nasıl seçildiğini anlayın.
- [Sağlayıcılar ve yetenekler](https://tahsil.dev/rehberler/odemeler/saglayicilar-ve-yetenekler.md): Banka ve ödeme kuruluşu kataloğunu, credential şemasını ve POS yeteneklerini okuyun.
- [Sanal POS kurulumu](https://tahsil.dev/rehberler/odemeler/sanal-pos-kurulumu.md): Sağlayıcı seçimi, credential yazma, oran planı ve aktivasyon sırasını uygulayın.
- [Sandbox ve test senaryoları](https://tahsil.dev/rehberler/odemeler/sandbox-ve-test.md): POS, oran, 3DS, failover, iptal, iade ve webhook entegrasyonunu production öncesi doğrulayın.
- [3DS ödeme yaşam döngüsü](https://tahsil.dev/rehberler/odemeler/uc-d-guvenli-odeme.md): 3DS yönlendirmesi, callback, canonical sonuç ve browser dönüşünün rollerini ayırın.
- [Webhook ve imza doğrulama](https://tahsil.dev/rehberler/odemeler/webhooklar.md): Ödeme olaylarını güvenli, idempotent ve yeniden denemeye dayanıklı biçimde tüketin.
- [Otomasyon kuralları ve atamalar](https://tahsil.dev/rehberler/otomasyon-kurallari.md): Hareket eşleştirme, önizleme, backfill ve manuel atama akışları.
- [Ödeme orkestrasyonuna genel bakış](https://tahsil.dev/rehberler/sanal-pos-ve-odemeler.md): Sanal POS ödemelerinin banka hareketlerinden farkını, tarafları ve uçtan uca yaşam döngüsünü anlayın.
- [Sayfalama ve CSV](https://tahsil.dev/rehberler/sayfalama-ve-csv.md): Offset, cursor ve güvenli export davranışları.
- [Zamanlanmış sorgular](https://tahsil.dev/rehberler/zamanlanmis-sorgular.md): Polling schedule oluşturma, duraklatma ve sağlık takibi.

## OpenAPI Specs

- [openapi](https://tahsil.dev/openapi/openapi.yaml)