API Sağlayıcıları Kurulum Rehberi

Altyapı API Bağlanabilirliği

API Sağlayıcılarını bağlamak, kredi kartı işlemlerini yapabilmeniz, işlemsel e-postaları teslim edebilmeniz ve SMS (OTP) gönderebilmeniz için platformunuzun temel işleyişi için şarttır. Aynı anda yalnızca bir aktif ödeme sağlayıcısına sahip olabileceğinizi unutmayın.

---

1. Ödeme Ağ Geçitleri (Payment Gateways)

Orbitus varsayılan olarak Stripe (Global), PayTR (Türkiye) ve Iyzico (Türkiye ve MENA) destekler.

Stripe Yapılandırması

1. Stripe Kontrol Paneli'ne giriş yapın.
2. Test işlemi (sandbox) yapmak istiyorsanız "Test Mode"u açın, canlı ödeme (Production) alacaksanız kapalı bırakın.
3. Geliştiriciler (Developers) > API Anahtarları (API keys) sekmesine gidin.
4. Secret Key'inizi (sk_live_ ile başlar) açığa çıkarın ve kopyalayın. Publishable Key'i (pk_live_) kopyalayın.
5. Orbitus > Entegrasyonlar > Ödeme bölümünde sekmelerden "Stripe"ı seçin. İki anahtarı da yapıştırın.
6. İsteğe Bağlı Webhook: Stripe'da Webhook'lara gidin. Uç nokta (endpoint) olarak https://alanadiniz.com/api/webhooks/stripe adresini ekleyin. İmzalama Sırrını (whsec_...) kopyalayıp Orbitus'taki "Webhook Secret" alanına yapıştırın.
7. Bağlantıyı Test Et'e tıklayın ve kaydedin.

PayTR Yapılandırması

1. PayTR Mağaza Paneline giriş yapın.
2. Bilgiler (Information) bölümüne gidin.
3. Tam olarak üç değere ihtiyacınız olacak: Merchant ID (Mağaza No), Merchant Key (Mağaza Parolası) ve Merchant Salt (Mağaza Gizli Anahtarı).
4. Orbitus > Entegrasyonlar > Ödeme (Payment) bölümüne gidin ve "PayTR" sekmesini seçin.
5. Anahtarları eksiksiz yapıştırın. Test edip kaydedin.

Iyzico Yapılandırması

1. Iyzico Kontrol Paneline (test için sandbox.iyzipay.com) giriş yapın.
2. Ayarlar > Firma Kimlik Bilgileri'ne gidin.
3. Hem API Key (API Anahtarı) hem de Secret Key (Güvenlik Anahtarı) değerlerini kopyalayın.
4. Orbitus'ta "Iyzico"yu seçin, anahtarları yapıştırın ve geliştirme (test) kimlik bilgilerini kullanıyorsanız "Sandbox Mode" kutusunu işaretleyin. Test edip kaydedin.

---

2. E-posta (Email) Sağlayıcı Yapılandırması

E-posta teslim edilebilirlik oranlarınızı büyük ölçüde artırmak için SMTP veya yerel HTTP API sağlayıcılarını (Resend, SendGrid, Amazon SES gibi) bağlayın.

Yapılandırma arayüzü değişebilir. SMTP bağlantıları için genellikle Sunucu (Host), Bağlantı Noktası (Port), Kullanıcı Adı ve Parola veya Resend gibi platformlar için API Key gerektirir.

---

3. SMS Sağlayıcı Yapılandırması

Dünya çapında kısa mesajlar (veya OTP) göndermek için SMS sağlayıcılarını bağlayın.

Orbitus > Entegrasyonlar > SMS konumuna gidin. Yüklü sağlayıcı sürücünüze (Twilio, Netgsm vb.) bağlı olarak farklı kimlik bilgileri gerekecektir. Canlı mesaj göndermeden önce Gönderici Kimliğinizin (Alfanumerik Başlık) operatör tarafından onaylandığından emin olun.