DurumEN
BaşlarkenPayment OrchestratorCüzdanBanka HesaplarıSigortaFraud & Fraud AIIdentitySanctionAutomationSDKDemo
Payment Orchestrator
Linkle Ödeme
Genel Bakış

Linkle Ödeme

Linkle Ödeme, alıcınıza bir adres gönderip ödemeyi Lunixi'nin barındırdığı sayfada almanızı sağlar:

https://pay.lunixi.com/7KQ2M9XAPT

Linki sunucunuzdan API ile oluşturursunuz (bu bölümde anlatılan yüzey); isterseniz aynı işlemleri panelden de yapabilirsiniz. Alıcı linki açtığında tutarı, adedi ya da kalemleri ve sizin istediğiniz bilgileri girer; ödeme adımında Checkout Formu entegrasyonunda kullanılan aynı Lunixi ödeme formunu görür. Kart alanları, taksit, 3D Secure ve panelinizdeki form ayarları link ödemelerinde de aynen geçerlidir.

Linkle Ödeme ayrı bir ürün değildir: PAYMENT_GATEWAY ürününüzün parçasıdır. Link için ayrı bir ücret yoktur; linkle alınan ödemeler normal işlem ücretine tabidir.

Tüm tutarlar minor-unit (kuruş) cinsinden tam sayıdır: "amountMinor": 150000 = ₺1.500,00. Bu kural istek gövdesindeki bütün *Minor alanları için geçerlidir. Webhook data'sında tutarlar minor-unit string olarak döner.

Ne zaman kullanılır

  • Kişiye özel tahsilat — fatura, hizmet bedeli, kapora. Tek kullanımlık, sabit tutarlı bir link; ödeme alınınca kapanır.
  • Ürün ya da bilet satışı — çok kullanımlık link, alıcı adet seçer, toplam kapasite tanımlarsınız.
  • Bağış ya da serbest tutar — alıcı tutarı kendisi girer; en az tutarı ve önerilen tutar düğmelerini siz belirlersiniz.
  • Kalemli satış — beden, seans, paket gibi seçenekler; toplam sunucuda hesaplanır, her kalemin kendi stoğu olabilir.
  • Yüz yüze tahsilat — linkin QR kodunu basar ya da ekranda gösterirsiniz.

Link tipleri

Bir linkin tipi iki alanla belirlenir. Her kombinasyon geçerlidir; usage, amountMode ve currency oluşturulduktan sonra değiştirilemez.

usageAnlamı
SINGLE_USETek bir başarılı ödeme alır; ödeme alınınca link COMPLETED olur. Aynı anda yalnız bir alıcı ödeme adımında olabilir — bir ödeme sürerken ikinci alıcı linki meşgul görür.
MULTI_USEBirden çok başarılı ödeme alır. İsteğe bağlı capacity ile toplam birim sayısını sınırlarsınız; kapasite dolunca link açık kalır ama "tükendi" görünür ve kapasiteyi artırabilirsiniz.
amountModeAnlamı
FIXEDTutarı siz belirlersiniz (amountMinor). Çok kullanımlık linkte alıcıya adet seçtirebilirsiniz (quantityEnabled).
OPENTutarı alıcı girer. En az tutar (minAmountMinor) zorunludur; en çok tutar ve en fazla 6 önerilen tutar isteğe bağlıdır.
ITEMIZEDAlıcı 1–50 kalem arasından adet seçer. Toplam sunucuda hesaplanır; kalem başına fiyat ve stok tanımlarsınız.
⚠️

3D Secure politikası: OPEN tutarlı ve MULTI_USE linklerde 3D Secure her zaman zorunludur ve kapatılamaz. Tek kullanımlık, sabit tutarlı linklerde form ayarlarınızdaki 3D politikası geçerlidir; checkout.requireThreeDs: true göndererek bu linkte de zorunlu kılabilirsiniz.

Nasıl çalışır

Linki oluşturun (sunucu)

POST /api/v1/payments/links — API anahtarınızla imzalanmış istek ve Idempotency-Key ile. Yanıt linkin id'sini, 10 karakterlik shortCode'unu ve paylaşacağınız url'yi döner. → Link Oluşturma

Paylaşın

Adresi kendi kanalınızdan (e-posta, mesajlaşma uygulaması, fatura) iletin, GET /:id/qr ile QR kodunu indirin ya da POST /:id/send ile Lunixi üzerinden gönderin. → Linkleri Yönetme

Alıcı öder

Alıcı pay.lunixi.com üzerindeki sayfada bilgilerini girer ve Öde ile Lunixi ödeme formuna geçer. 3D Secure gerekiyorsa bankasında doğrulama yapar. → Ödeme Sayfası

Sonucu webhook ile alın

Ödeme tahsil edildiğinde endpoint'inize payment.captured gelir; payload paymentLinkId ve paymentLinkCode taşır. Siparişi bu event'le teslim edin. Tek kullanımlık link ödeme tahsil edilince COMPLETED olur ve payment.link.completed yayınlanır. → Webhook'lar

Yaşam döngüsü

Ödeme linki yaşam döngüsüLink ACTIVE olarak oluşturulur. ACTIVE ile PAUSED arasında pause ve resume ile geçilir. Açık bir link, tek kullanımlıkta ödeme alınınca COMPLETED, süresi dolunca EXPIRED, merchant iptal edince DEACTIVATED olur. Lunixi her durumdaki linki TAKEN_DOWN yapabilir; geri alındığında link önceki durumuna döner.AÇIKSONLANDI — GERİ DÖNÜŞ YOKACTIVEPAUSEDpauseresumetek kullanımlık link ödendiexpiresAt geçtideactivateCOMPLETEDEXPIREDDEACTIVATEDLunixi kaldırdı (her durumdan)TAKEN_DOWNgeri alınırsa önceki duruma dönerAÇIKLAMAÖDEME ALIRYALNIZ LUNIXI
Açık durumlar arasında gidip gelebilirsiniz; sonlanan durumdan geri dönüş yoktur — tekrar ödeme almak için yeni link oluşturun. TAKEN_DOWN'a yalnız Lunixi alır ve yalnız Lunixi geri alabilir.
stateAnlamıÖdeme alır mı
ACTIVELink açık. startsAt henüz gelmediyse sayfa açılır ama ödeme başlatılamaz.Evet
PAUSEDSiz duraklattınız. Sayfa açılır, ödeme alınmaz; resume ile açarsınız.Hayır
COMPLETEDTek kullanımlık link ödendi. Ödeme sonradan iade edilse de link yeniden açılmaz.Hayır
EXPIREDexpiresAt geçti.Hayır
DEACTIVATEDSiz iptal ettiniz.Hayır
TAKEN_DOWNLunixi linki yayından kaldırdı (ör. oltalama bildirimi, marka taklidi). Bu linkte değişiklik ve gönderim yapamazsınız.Hayır

Alıcı ne görür

  • Sayfanın başında organizasyonunuzun yasal adı birincil kimlik olarak, markanız (logo, renkler, görünen ad) ikincil olarak gösterilir.
  • Link başlığı, açıklaması, tutar ya da tutar seçenekleri, sizin istediğiniz alıcı alanları ve özel alanlar.
  • Kişiye özel linkte alıcının adı ve iletişim bilgisi yalnız maskeli görünür (A*** Y***). İsterseniz linke e-posta ile erişim doğrulaması eklersiniz.
  • Bilinmeyen bir adres 404, süresi dolmuş, ödenmiş, iptal edilmiş ya da kaldırılmış bir link 410 sayfası gösterir.

Ayrıntılar: Ödeme Sayfası.

Güvenlik ve gizlilik

  • Link kodu bir sır değildir. Linki bilen herkes sayfayı açabilir. Bu yüzden sayfa alıcı kişisel verisi göstermez: önceden doldurduğunuz alıcı bilgileri (prefill) ödeme kaydına sunucu tarafında yazılır ve tarayıcıya gönderilmez. Tek istisna, linke erişim doğrulaması eklediğiniz durumdur: e-postasına gelen kodu giren alıcı bu bilgileri formda görür. TC kimlik numarası hiçbir durumda sayfada görünmez.
  • Tutar, para birimi ve merchant bilgisi yalnız linkten okunur. Alıcı bunları değiştiremez; tarayıcıdan gelen tutar yalnız OPEN linkte ve sizin sınırlarınız içinde kabul edilir.
  • Link başka bir linke dönüşmez. Kodlar tekrar kullanılmaz: iptal edilen ya da süresi dolan bir linkin adresi yıllar sonra da başka bir ödemeye açılmaz.
  • Bu linki bildir. Alıcı şüpheli bir linki sayfadan Lunixi'ye bildirebilir; bildirimler Lunixi tarafından incelenir.

Test ortamı

  • Taban adres aynıdır; ortamı API anahtarınız belirler. mk_test_sk_… anahtarınızla oluşturduğunuz linkler TEST ortamındadır, sayfasında sabit "TEST — ödeme alınmaz" şeridi görünür ve gerçek para çekilmez. Ödeme adımında Test Ortamı sayfasındaki TestBank senaryolarını kullanırsınız.
  • Bir anahtar yalnız kendi ortamının linklerini görür: test anahtarıyla canlı bir linke yapılan istek 404 döner.
  • TEST ortamında Lunixi'nin yaptığı gönderimler (link gönderme, hatırlatma, makbuz, ödeme bildirimi, erişim doğrulama kodu) yalnız organizasyonunuzun doğrulanmış üyelerinin e-posta adreslerine gider; diğer alıcılar FAILED / test_mode_recipient_not_allowed olarak kaydedilir. TEST ortamında SMS gönderilmez.

Sınırlar

  • Link başına tek para birimi; hesabınızın o ortamda tanımlı ödeme sağlayıcılarının desteklediği birimlerden biri olmalıdır.
  • Link ödemelerinde SplitPay (çoklu kart) kullanılamaz ve alıcıya kayıtlı kart gösterilmez.
  • Alıcıdan dosya yükleme alanı yoktur. Sayfa dilleri: Türkçe ve İngilizce.
  • Link QR kodu bir URL QR'ıdır; TR Karekod değildir.
  • Ön provizyonlu (authorize, sonra capture) link, toplu link oluşturma, link ve kalem görselleri ve linkin sitenize gömülen bileşeni: çok yakında.

Sonraki adımlar

  • Link Oluşturma — kimlik doğrulama, bütün alanlar, örnek istekler
  • Linkleri Yönetme — listeleme, güncelleme, duraklatma, gönderme, QR
  • Ödeme Sayfası — alıcı deneyimi, marka, erişim doğrulaması, makbuz
  • Webhook'lar — payment.link.* event'leri ve siparişi teslim etme kuralı
Adres BilgileriLink Oluşturma