Ortamlar ve Erişim
Partner API iki ayrı ortamda çalışır: entegrasyonu geliştirip denediğiniz Test ortamı ve gerçek tahsilatın yapıldığı Canlı ortam. Host adresleri herkese açık yayımlanmaz; erişim talebiniz onaylandığında size iletilir.
Ortamlar
| Test | Canlı | |
|---|---|---|
| Amaç | Geliştirme ve uçtan uca deneme | Gerçek kart, gerçek para hareketi |
| Base URL | Erişim talebi sonrası iletilir | Canlı onayı sonrası iletilir |
| API anahtarı | Test ortamının işletme panelinden | Canlı işletme panelinden |
| Kartlar | Test kartları | Gerçek kartlar |
Dokümandaki örneklerde host https://<host> olarak geçer; size iletilen base URL ile değiştirin. İstek yolu (/partner/1.0/...) her iki ortamda aynıdır.
Anahtarlar ortama özeldir
Test ortamında üretilen anahtar canlı ortamda tanınmaz (HTTP 401, invalid api key); her ortam için ayrı entegrasyon oluşturun.
ok_test_ / ok_live_ öneki ortam seçmez: ok_test_ anahtarla yapılan işlem yalnızca sandbox olarak etiketlenir. Ayrıntı: Test Kartları.
Bağlantı Kuralları
| Kural | Değer |
|---|---|
| Protokol | Yalnız HTTPS |
| Hız limiti | API anahtarı başına dakikada 300 istek; aşılırsa HTTP 429. |
| IP kısıtlaması | Opsiyonel. Entegrasyona izinli IP'ler tanımlanabilir; tam IP eşleşmesi aranır (CIDR aralığı desteklenmez). İzinsiz IP'den gelen istek HTTP 401. |
| Saat farkı | X-Timestamp sunucu saatinden en fazla ±5 dakika sapabilir; bkz. Kimlik Doğrulama. |
Erişim Adımları
- Kaptan işletme hesabınız yoksa başvuru yapın.
- Aşağıdaki formla test ortamı erişimi talep edin; ekibimiz host bilgisini ve test sağlayıcı tanımını iletir.
- İşletme panelinde entegrasyon oluşturup API anahtarı + secret alın. Secret yalnızca bir kez gösterilir; bkz. Kimlik Doğrulama.
- Test ortamında akışlarınızı test kartlarıyla doğrulayın.
- Canlı ortam için aynı formdan “Canlı” seçerek talep oluşturun.
Secret paylaşmayın
Destek ekibi hiçbir zaman API secret, kart numarası veya CVV istemez. Talep ve yazışmalarda bu bilgileri paylaşmayın.