Hesap Açılışı ve İlk Giriş

Bu sayfa hesabınızın açılışından ilk tahsilata kadar yapılacakları anlatır. Hangi adımı LydiaGate’in, hangi adımı sizin yaptığınızı burada görürsünüz.

Test ve canlı ortam için ayrı hesaplar açılır. Bu sayfadaki adımlar iki ortamda da aynıdır. Önce test hesabında ilerleyin. Canlı hesabı LydiaGate test tamamlanınca açar. Ortam adresleri: Ortamlar ve Ağ Erişimi.

LydiaGate’in yaptıkları

1. Kurumunuz için LydiaGate’te bir hesap açar.
2. Halkbank’tan gelen sanal POS bilgilerini hesabınıza tanımlar.
3. Ödemelerin yönlendirileceği terminali oluşturur ve terminal kimliği olan terminalId değerini size iletir. Terminal, sanal POS bağlantısının kurumunuza özel tanımıdır.
4. Komisyon oranlarını ve izinli taksit sayılarını terminale tanımlar.
5. İlk panel kullanıcısını cep telefonu numarasıyla açar. Bu kullanıcı yöneticidir ve diğer kullanıcıları kendisi ekler.
6. Hesap kurulumu bitince ödeme alımını açar.

Sizin yapacaklarınız

1. Panele ilk giriş

İş Ortağı Paneli’ne tarayıcıdan girersiniz. Test adresi https://test-panel.lydiagate.com. Canlı adres hesap açılışı tamamlanınca size iletilir.

1. Giriş yöntemini seçin: cep telefonu ya da e-posta.
2. Kayıtlı cep telefonu numaranızı ya da e-posta adresinizi girin.
3. Size gelen 6 haneli tek kullanımlık kodu (OTP) girin.

Girişte kalıcı şifre yoktur. Her girişte yeni bir kod gelir. Ekranların ayrıntısı: Panel Kılavuzu.

2. Sözleşme onayı

Zorunlu sözleşmeler onaylanmadan hesabınız ödeme alamaz. Sözleşmeleri panelde Yönetim → Sözleşmeler ekranında bulursunuz. Sözleşmeyi açıp okuyun, “Okudum, işletme adına kabul ediyorum” kutusunu işaretleyin ve “Sözleşmeyi onayla” düğmesine basın. Onay için “Sözleşme onaylama” yetkisi gerekir. Bu yetki işletme yöneticisinde vardır ve çalışana da verilebilir. Islak imza gereken sözleşmede imzalı belgeyi LydiaGate’e iletirsiniz.

3. Kullanıcılar ve yetkiler

Panelde Yönetim → Kullanıcılar ekranından personelinizi ekleyin. Her kullanıcıya yalnız işinin gerektirdiği yetkileri verin. Kullanıcı ekleme için “Çalışan yönetimi” yetkisi gerekir. Yetki listesi ve önerilen yetki setleri: Panel Kılavuzu.

4. API anahtarı

Panelde Geliştirici → API Anahtarları ekranından bir anahtar oluşturun. Anahtar, API isteklerinizi yetkilendirir. Anahtar tam haliyle yalnız bir kez gösterilir. Anahtarı sunucunuzun gizli ayarlarına kaydedin. Bu ekran için “API anahtarı yönetimi” yetkisi gerekir. Ayrıntı: API Anahtarı ile Erişim.

5. Webhook adresi

Panelde Geliştirici → Webhook Ayarları ekranından webhook adresinizi tanımlayın. Adres https ile başlamalı. Adres internetten erişilebilir olmalıdır. İmza secret’ını aynı ekrandan girersiniz. Bu ekran için “Webhook yönetimi” yetkisi gerekir. Ayrıntı: Webhooks.

Webhook adresi tanımlı değilse bildirim gönderilmez. Bu durumda ödeme sonuçlarını yalnız GET /v1/payments/{paymentCode} sorgusundan öğrenirsiniz.

6. Dönüş adresi

Kart sahibi 3D Secure adımından sonra sizin belirlediğiniz adrese döner. Bu adres ödeme isteğindeki returnUrl alanıdır. Dönüş adresinizin alan adını LydiaGate’e bildirin. LydiaGate bu alan adını hesabınıza izinli dönüş adresi olarak tanımlar. İzinli liste tanımlandıktan sonra listede olmayan bir alan adıyla gönderilen ödeme isteği 400 ile reddedilir.

7. Ödeme kabul durumunu kontrol edin

Hesabınızın yeni ödeme alıp alamadığını GET /v1/payment-acceptance ucundan sorgulayın. acceptingPayments değeri true ise ilk tahsilatı yapabilirsiniz. Sonraki adım: Hızlı Başlangıç.

Ödeme kabul durumu

Hesabınızın şu anda yeni ödeme alıp alamadığını GET /v1/payment-acceptance ucundan öğrenirsiniz. Ödeme alımı kapalıyken POST /v1/payments isteği 403 ve payment_acceptance_held koduyla reddedilir. Daha önce oluşturulmuş ödemelerin tamamlanması, sorgular ve iadeler bu durumdan etkilenmez.

İstek

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

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

Yanıt

Kurulumu henüz bitmemiş bir hesap için 200 OK:

{
  "acceptingPayments": false,
  "partnerStatus": "active",
  "holds": [
    {
      "reason": "admin_hold",
      "effective": true,
      "effectiveAt": "2026-10-02T09:15:00Z",
      "since": "2026-10-02T09:15:00Z",
      "agreements": null
    }
  ]
}

Ödeme almaya hazır bir hesap için 200 OK:

{
  "acceptingPayments": true,
  "partnerStatus": "active",
  "holds": []
}

Alan	Anlamı
acceptingPayments	Hesabınız şu anda yeni ödeme alabilir mi. Hesap durumu suspended ya da closed ise her zaman false olur.
partnerStatus	Hesap durumu: active aktif, suspended askıda, closed kapalı.
holds	Ödeme alımını durduran nedenlerin listesi. Neden yoksa boş liste döner. Sıralama effectiveAt alanına göre artandır.
holds[].reason	Nedenin kodu: agreements_pending ya da admin_hold. Nedenler bölümünde açıklanır.
holds[].effective	Neden şu anda etkin mi. false ise neden effectiveAt anında başlayacaktır.
holds[].effectiveAt	Nedenin başladığı ya da başlayacağı an. UTC ve ISO-8601 biçiminde.
holds[].since	Nedenin kaydedildiği an. UTC, ISO-8601 biçiminde.
holds[].agreements	Yalnız agreements_pending nedeninde dolu. Tamamlanmamış sözleşmeleri listeler. Diğer nedende null.

agreements listesindeki her sözleşmenin alanları:

Alan	Anlamı
agreementCode	Sözleşmenin kodu.
agreementName	Sözleşmenin adı.
version	Sözleşmenin sürümü.
requirement	consent panelden onay, wet_signature ıslak imza.
kind	first ilk onay, renewal yenileme.
deadlineAt	Sürenin dolduğu an. Süre penceresi yoksa null.
lastDay	Sözleşmeyi tamamlayabileceğiniz son gün. Türkiye saatiyle, o gün dahil. Süre penceresi yoksa null.
expired	Süre doldu mu.
effectiveAt	Bu sözleşmenin ödeme alımını durdurduğu ya da durduracağı an.

Nedenler

agreements_pending: Onaylamanız ya da ıslak imzayla teslim etmeniz gereken bir sözleşme var. Ödeme alımının şu anda durup durmadığını effective ve acceptingPayments alanlarından anlarsınız. Sözleşmeyi onaylayın. Sözleşme tamamlanınca bu neden kendiliğinden kalkar.

admin_hold: Ödeme alımını LydiaGate durdurdu. Yeni hesaplarda bu neden, kurulum tamamlanıp onaylanana kadar bulunur. Ayrıntı için LydiaGate destek ekibiyle iletişime geçin.

Kullanım önerileri

• Her ödeme öncesi bu ucu çağırmanız gerekmez. 403 ve payment_acceptance_held aldığınızda nedeni öğrenmek için çağırın.
• Aynı isteği tekrar göndermek sonucu değiştirmez. Önce nedeni giderin.

Kontrol listesi

Adım	Nerede yapılır	Gereken yetki
Panele ilk giriş	Panel giriş ekranı	Kayıtlı kullanıcı
Sözleşme onayı	LydiaGate ile birlikte	“Sözleşme onaylama”
Kullanıcı ekleme	Yönetim → Kullanıcılar	“Çalışan yönetimi”
API anahtarı	Geliştirici → API Anahtarları	“API anahtarı yönetimi”
Webhook adresi ve secret	Geliştirici → Webhook Ayarları	“Webhook yönetimi”
Dönüş adresi bildirimi	LydiaGate’e iletilir	Yetki gerekmez
Ödeme kabul kontrolü	GET /v1/payment-acceptance	API anahtarı