İçeriğe geç
LydiaGateLydiaGateBelediye

Ödeme Sorgula

Bu sayfa ödeme sorgulama ucunu anlatır. Ödeme koduyla ya da kendi işlem kodunuzla sorgularsınız.

Bir ödemenin kesin durumunu ve tutar dökümünü bu uçtan öğrenirsiniz. Kart sahibinin returnUrl adresine taşıdığı bilgi tarayıcıdan geldiği için kesin sayılmaz. Kesin sonucu her zaman bu uçtan ya da webhook ile alırsınız. İki biçim vardır. Uç GET isteğiyle çağrılır.

Ödeme koduna göre

Bölüm başlığı “Ödeme koduna göre”
GET /v1/payments/{paymentCode}
Authorization: Bearer ldg_test_…

paymentCode, ödeme oluşturma yanıtında dönen kalıcı kimliktir. Kesin sorgu için bu kodu saklayın.

Kendi işlem kodunuza göre

Bölüm başlığı “Kendi işlem kodunuza göre”

Kendi partnerTxCode değerinizle de sorgulayabilirsiniz. Webhook gelmeden önce durum kontrolü için kullanışlıdır.

GET /v1/payments?partnerTxCode=SU-2026-10-000123
Authorization: Bearer ldg_test_…

Yanıt

Bölüm başlığı “Yanıt”

200 OK:

{
  "paymentCode": "pay_7Hq2bL",
  "partnerTxCode": "SU-2026-10-000123",
  "status": "captured",
  "amount": 15563,
  "currency": "try",
  "installmentCount": 1,
  "maskedPan": "543081******9115",
  "cardFamily": "credit",
  "cardBank": "Örnek Banka",
  "appliedRateBps": 375,
  "appliedFixedFee": null,
  "commissionAmount": 563,
  "netToPartner": 15000,
  "expectedValueDate": "2026-10-24",
  "refunds": [],
  "createdAt": "2026-10-23T09:00:00Z",
  "updatedAt": "2026-10-23T09:05:11Z"
}
Alan Anlamı
paymentCode LydiaGate ödeme kimliği.
partnerTxCode Sizin işlem kodunuz.
status Ödemenin kesin durumu. Ayrıntı: Ödeme Durumları.
amount Kart sahibinden çekilen toplam tutar, kuruş. Komisyon bu tutarın içindedir.
currency Para birimi. Her zaman try.
installmentCount Taksit sayısı. Tek çekim için 1.
maskedPan Maskeli kart numarası. Tam kart numarası hiçbir zaman dönmez. Henüz belirlenmemişse null.
cardFamily Kart ailesi: credit kredi kartı, debit banka kartı, prepaid ön ödemeli kart, foreign yurt dışı kart. Bilinmiyorsa null.
cardBank Kartı çıkaran banka. Bilinmiyorsa null.
appliedRateBps Uygulanan komisyon oranı, baz puan tamsayı. Baz puan, yüzdenin yüzde biridir. %3,75 → 375. Henüz hesaplanmadıysa null.
appliedFixedFee Uygulanan sabit ücret, kuruş. Yoksa null.
commissionAmount Bankaya bildirilen komisyon, kuruş. Henüz hesaplanmadıysa null.
netToPartner Kurumunuzun hesabına geçecek anapara, kuruş. amount − commissionAmount değerine eşittir. Henüz hesaplanmadıysa null.
expectedValueDate Paranın hesabınıza geçmesi beklenen tarih. Kesin tarihi banka belirler. Henüz belirlenmemişse null.
refunds İade ve iptal kalemleri. Her kalemde refundId, amount ve status vardır. status değerleri: pending bekliyor, approved onaylandı, declined reddedildi. İade yoksa boş liste. Ayrıntı: İade ve İptal.
createdAt Ödemenin oluşturulduğu an.
updatedAt Son güncelleme anı. UTC, ISO-8601 biçiminde.