Ödeal Developer Portal'a Hoşgeldiniz

Modern ödeme çözümleri için kapsamlı entegrasyon rehberiniz

🎯 Hızlı Başlangıç

Bu portal, E-FaturaPos ve Sadepos hizmetleriyle güvenli ödeme entegrasyonu için ihtiyacınız olan her şeyi içerir.

🌀 Ödeal Hizmetleri

🧾 E-FaturaPos

VUK 507 Uyumlu E-Belge Çözümü

E-FaturaPos, VUK 507 mevzuatı çerçevesinde çalışan ve cihaz üzerinden gerçekleştirilen işlemlerin e-belgesini otomatik oluşturan yeni nesil hizmettir.

Temel Özellikler

• ✅ Otomatik e-fatura oluşturma
• ✅ E-arşiv fatura desteği
• ✅ VUK 507 tam uyumlu
• ✅ Anlık belge gönderimi

💳 SadePos

Basit & Güvenli Ödeme Çözümü

Yazar kasa fonksiyonu olmayan, sadece ödeme ve tahsilat almak için tasarlanmış EFT POS hizmeti.

Temel Özellikler

• ✅ Hızlı ödeme işlemi
• ✅ Kolay entegrasyon
• ✅ Minimum konfigürasyon
• ✅ E-belge gerektirmez

🌐 API Endpoint'leri

Tüm entegrasyon senaryolarında kullanacağınız REST servisleri aşağıdaki base URL'ler üzerinden sunulur.

Stage (Test Ortamı)

https://stage.odealapp.com/api/v1

Production (Canlı Ortam)

https://api.odeal.com/api/v1

🧩 Entegrasyon Profilleri

📱 Entegrasyonlu Profiller

📲 App2App

Mobil uygulama sahipleri için ideal çözüm

Cihazda bulunan İş Ortağı ve Ödeal uygulamalarının sorunsuz entegrasyonu.

Çalışma Prensibi

1. İş ortağı uygulamasında sepet hazırlanır
2. Ödeme işlemi Ödeal'a aktarılır
3. Ödeme tamamlanır ve e-belge oluşturulur

Kimler İçin Uygun?

• ✅ Kendi mobil uygulamanız var
• ✅ Uygulama içi ödeme deneyimi istiyorsunuz
• ✅ E-belge entegrasyonu gerekiyor

🖥️ Device2Device

Harici cihaz kullanıcıları için güçlü çözüm

Ödeal POS cihazına iş ortağı cihazının entegre edildiği sistem.

Çalışma Prensibi

1. Sepet iş ortağı cihazında oluşturulur
2. Ödeal cihazına gönderilir
3. Ödeme Ödeal tarafından tamamlanır

Kimler İçin Uygun?

• ✅ Tablet, PC gibi harici cihaz kullanıyorsunuz
• ✅ POS entegrasyonu istiyorsunuz
• ✅ Merkezi sepet yönetimi gerekiyor

💸 App to Direct Charge

Hızlı tahsilat için pratik çözüm

Sadece ödeme/tahsilat işlemlerinin alındığı basit profil.

Farkı Nedir?

Direct Charge'dan farkı işlem tutarının cihazdan değil, iş ortağı uygulamasından iletilmesi.

Kimler İçin Uygun?

• ✅ Sadece ödeme almak istiyorsunuz
• ✅ E-belge gerekmez
• ✅ Hızlı tahsilat önceliğiniz

---

📊 Hangi Profil Size Uygun?

Aşağıdaki tablo ile ihtiyaçlarınıza göre öne çıkan profili hızlıca seçebilirsiniz.

Kriter	Device2Device	App2App
📱 Mobil uygulamanız var mı?	❌	✅
💻 Tablet, PC gibi harici cihazlardan mı sepet oluşturmaktasınız?	✅	❌
📄 E-belge entegrasyonu gerekli mi?	✅	✅
⚡ Hızlı kurulum önceliği	⭐⭐	⭐⭐⭐

---

🔌 Entegrasyonsuz Profiller

Internal Basket

Tamamen Ödeal tabanlı çözüm

Sadece Ödeal uygulaması üzerinden işlemlerin alınarak e-belgenin oluşturulduğu profil.

Direct Charge

Basit tahsilat çözümü

Ödeal uygulaması üzerinden sadece ödeme/tahsilat işleminin alındığı profil.

🛠️ Entegrasyon Servisleri

📏 Birim Servisi

Gerekli

GET /api/v1/units

Amaç: Ürün birimleri (adet, kg, lt vb.) listesini çeker.

💡 Önemli Not

Ürün eklemeden önce mutlaka birim kodları çekilmelidir. App2App ve Device2Device entegrasyonlarında Ödeal birim formatı kullanılmalıdır.

📚 API Dokümantasyonu

🛒 Sepet Servisi

Ana Servis

POST /api/v1/basket

Amaç: İş ortakları ile sepet aktarımlarının gerçekleştirildiği core servis.

Profile göre farklı entegrasyon modelleri desteklenir.

📚 API Dokümantasyonu

🔔 Geri Bildirim Servisi

Webhook

POST /callback/payment-result

Amaç: İşlem sonuçlarının (satış, iptal) ve e-fatura bildirimlerinin iletildiği webhook servisi.

Callback Yapılandırması

Konfigürasyon servisinde callback URL'inizi tanımlamayı unutmayın!

📚 API Dokümantasyonu

⚙️ Konfigürasyon Servisi

İlk Kurulum

POST /api/v1/configuration

Amaç: Entegrasyon için gerekli URL ve ayarların kaydedildiği servis.

Kaydedilecek Bilgiler

• 🔗 Callback URL'leri
• 🔐 Webhook secret'ları
• 📍 Endpoint konfigürasyonları

📚 API Dokümantasyonu

📈 Rapor Servisi

Analytics

GET /api/v1/report/transactions

Amaç: Belirli tarih aralığında gerçekleşen işlem detaylarının sorgulandığı servis.

Kullanılabilir Filtreler

• 📅 Tarih aralığı
• 💳 İşlem tipi
• 📄 Belge durumu
• 💰 Tutar aralığı

📚 API Dokümantasyonu

🎯 Sonraki Adımlar

🚀 Entegrasyona Başlayın

1. Profil Seçimi
Size uygun entegrasyon profilini belirleyin

2. API Key
Ödeal'dan API anahtarınızı alın

3. Stage Test
Test ortamında entegrasyonunuzu deneyin

4. Prod Deploy
Production'a geçiş yapın

---

Yardıma mı ihtiyacınız var? API Reference bölümüne göz atın! 👉

---