Link ile Ödeme (pay-by-link)

Kart bilgileri sizin sisteminize gelmez, bunun yerine Ödeal tarafından sağlanan güvenli bir form sayfasında alınır. Bu yöntem sisteminiz kart bilgilerini hiç almadığından PCI-DSS gereksinimlerini minimuma indirir.

Ne Zaman Kullanılmalı?

• Müşteriye WhatsApp/SMS/E-posta ile ödeme linki göndermek istediğinizde
• Kart bilgilerini sisteminizde işlemek istemediğinizde
• PCI-DSS yükünü azaltmak istediğinizde
• Telefon/chat üzerinden satış yapıldığında

Akış

1. Link Talebi: Ödeme tutarı ve diğer bilgilerle link talebi yapılır (kart bilgisi gönderilmez)
2. Ödeme Linki: API'den checkout3DUrl döner
3. Link Paylaşımı: Bu link müşteriye iletilir (SMS, WhatsApp, e-posta vs.)
4. Kart Bilgileri: Müşteri link'teki formda kart bilgilerini girer
5. 3D Doğrulama: Otomatik olarak 3D doğrulama ekranına yönlendirilir
6. Callback: İşlem sonucu returnUrl adresinize POST edilir

Dikkat Edilmesi Gerekenler

• Kart bilgileri hiçbir zaman sizin sunucunuza gelmez
• checkout3DUrl linkinin geçerlilik süresi vardır
• Link tek kullanımlıktır, ödeme tamamlandıktan sonra geçersiz olur
• returnUrl callback için zorunludur

2. ID Saklama

API'den dönen id değerini mutlaka kaydedin. Bu ID ile:

• İşlem iptali yapabilirsiniz
• İade işlemi gerçekleştirebilirsiniz
• İşlem detaylarını sorgulayabilirsiniz

3. Callback Güvenliği

• Callback endpoint'inizi güvenli tutun (HTTPS)
• uniqueKey veya id ile mükerrer callback'leri filtreleyin
• Callback'i hızlıca işleyin ve HTTP 200 dönün
• Uzun işlemler için async/queue kullanın

4. Hata Yönetimi

• API hatalarını yakalarken result.message ve error.message alanını kontrol edin
• Timeout durumlarında işlem durumunu kontrol edin (CheckStatus API)
• Detaylar için: Hata Yönetimi

5. Test Ortamı

Canlıya geçmeden önce stage ortamında test edin:

• Base URL: https://apigwstg.odeal.com/mobile
• Test kartları ve senaryoları ile tüm akışları deneyin
• Callback mekanizmasını doğrulayın

6. Token Yönetimi

• Token süresini takip edin (expiresIn)
• Token expire olmadan önce refresh edin
• Her yeni token alındığında eski token geçersiz olur

Daha Fazla Bilgi

API detayları için: Link ile Ödeme API Referansı