Ödeme Kabul Durumu

Hesabınızın şu an yeni ödeme alıp alamadığını bu uçtan öğrenirsiniz. Ödeme alımı durdurulmuşsa yanıt nedenleri de listeler.

Ödeme alımı durdurulmuşken POST /v1/payments ve POST /v1/payment-links çağrıları 403 payment_acceptance_held ile reddedilir. Daha önce oluşturduğunuz ödemelerin tamamlanması, ödeme sorgulama ve iadeler bu durumdan etkilenmez.

İstek

GET /v1/payment-acceptance
Authorization: Bearer ldg_live_…

İstek gövdesi ve parametre yoktur. Yanıt her zaman API anahtarının ait olduğu hesabı anlatır.

Yanıt

200 OK:

{
  "acceptingPayments": false,
  "partnerStatus": "active",
  "holds": [
    {
      "reason": "agreements_pending",
      "effective": true,
      "effectiveAt": "2026-11-01T21:00:00Z",
      "since": "2026-10-02T09:15:00Z",
      "agreements": [
        {
          "agreementCode": "uye-isyeri-sozlesmesi",
          "agreementName": "Üye İşyeri Hizmet Sözleşmesi",
          "version": "2",
          "requirement": "consent",
          "kind": "first",
          "deadlineAt": "2026-11-01T21:00:00Z",
          "lastDay": "2026-11-01",
          "expired": true,
          "effectiveAt": "2026-11-01T21:00:00Z"
        }
      ]
    }
  ]
}

Alan	Açıklama
`acceptingPayments`	Hesabınız şu an yeni ödeme alabilir mi. Hesap durumu `suspended` ya da `closed` ise daima `false` olur.
`partnerStatus`	Hesap durumu: `active`, `suspended` ya da `closed`.
`holds`	Ödeme alımını durduran etkin nedenler. Kontrol devrede değilse boş liste döner. Sıralama `effectiveAt` artandır.
`holds[].reason`	`agreements_pending` ya da `admin_hold` (aşağıda).
`holds[].effective`	Neden şu an etkin mi. `false` ise neden `effectiveAt` anında başlayacaktır. Ödeme alıp alamayacağınızı her zaman `acceptingPayments` gösterir; etkin başka bir neden varsa ödeme alımı yine kapalıdır.
`holds[].effectiveAt`	Nedenin başladığı ya da başlayacağı an (UTC, ISO-8601).
`holds[].since`	Nedenin kaydedildiği an (UTC, ISO-8601).
`holds[].agreements`	Yalnız `agreements_pending` nedeninde dolu; tamamlanmamış sözleşmeleri listeler. Diğer nedenlerde `null`.
`agreements[].requirement`	`consent` (panelden onay) ya da `wet_signature` (ıslak imza).
`agreements[].kind`	`first` (ilk onay) ya da `renewal` (yenileme).
`agreements[].deadlineAt`	Sürenin dolduğu an (UTC). Süre penceresi yoksa `null`.
`agreements[].lastDay`	Sözleşmeyi tamamlayabileceğiniz son gün (Türkiye saatiyle, o gün dahil). Süre penceresi yoksa `null`.
`agreements[].expired`	Süre doldu mu.

Nedenler

`agreements_pending`

Hesabınızın onaylaması ya da ıslak imzayla teslim etmesi gereken bir sözleşme var ve süresi doldu. Sözleşmeyi Lydia Gate panelindeki sözleşmeler ekranından onaylayın. Islak imza gereken sözleşmede imzalı belgeyi Paytalya’ya iletin. Sözleşme tamamlanınca bu neden kendiliğinden kalkar. Başka etkin neden yoksa ödeme alımı yeniden açılır.

`admin_hold`

Ödeme alımını Paytalya durdurdu. Bu neden yeni hesaplarda, hesap kurulumu tamamlanıp onaylanana kadar da bulunur. Ayrıntı için Paytalya destek ekibiyle iletişime geçin.

Kullanım önerileri

Ödeme ya da ödeme linki oluşturmadan önce bu ucu her seferinde çağırmanız gerekmez. 403 payment_acceptance_held aldığınızda nedeni öğrenmek için bu ucu çağırın.
Aynı isteği tekrar göndermek sonucu değiştirmez. Önce nedeni giderin.
Ödeme alımı durdurulduğunda açık ödeme linklerinde alıcı kart formu yerine bir bilgi sayfası görür. Ayrıntı: Ödeme linkleri.

Olası hatalar

Kod	HTTP	Sebep
`rate_limited`	`429`	Kaynak-IP hız limiti aşıldı. `Retry-After` süresi dolduktan sonra tekrar deneyin.

Kimlik doğrulama hatası 401 döner. Tam liste: Hata Kodları.