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

TestCanlı
AmaçGeliştirme ve uçtan uca denemeGerçek kart, gerçek para hareketi
Base URLErişim talebi sonrası iletilirCanlı onayı sonrası iletilir
API anahtarıTest ortamının işletme panelindenCanlı işletme panelinden
KartlarTest 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ı

KuralDeğer
ProtokolYalnız HTTPS
Hız limitiAPI 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ı

  1. Kaptan işletme hesabınız yoksa başvuru yapın.
  2. Aşağıdaki formla test ortamı erişimi talep edin; ekibimiz host bilgisini ve test sağlayıcı tanımını iletir.
  3. İşletme panelinde entegrasyon oluşturup API anahtarı + secret alın. Secret yalnızca bir kez gösterilir; bkz. Kimlik Doğrulama.
  4. Test ortamında akışlarınızı test kartlarıyla doğrulayın.
  5. 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.

Erişim Talebi

Erişim Talep Formu
Gönder, doldurulmuş bir e-posta taslağı açar (destek@kaptan.co). Kart veya secret bilgisi yazmayın.
Talep edilen ortam