Ana içeriğe geç
Mevzuat RadarDokümantasyon
Uygulamaya git ↗

Sandbox ve canlıya geçiş

Entegrasyon uygulaması kapalı beta kapsamındadır. Onaylanan uygulama önce test ortamında (SANDBOX) çalışır; canlı kurum bağlantısı için ayrıca canlıya geçiş incelemesi gerekir.

Test kurumu

Her geliştirici firmaya tek bir test kurumu atanır; firmanın tüm uygulamaları aynı test kurumunu kullanır.

İşlemAPI yoluYetki
Test kurumu ve örnek veriyi okumaGET /api/v1/integration-apps/{id}/sandboxFirma ADMIN, settings:read
Test olayı göndermePOST /api/v1/integration-apps/{id}/sandbox/test-eventFirma ADMIN, settings:write

Okuma yanıtı test kurumunun örnek verisini ve doğrulanmış, herkese açık en fazla 20 GİB / Çalışma ve SGK mevzuatının kimlik, başlık ve kaynak bilgisini döndürür. Test olayı BOARD_REPORT_READY türünde, livemode: false olarak uygulamanın bu olaya abone etkin uçlarına gönderilir; yanıttaki queued alanı kuyruğa alınan uç sayısıdır.

livemode ayrımı

  • Test sırrı (mr_app_test_) yalnız test kurumuyla, canlı sır (mr_app_live_) yalnız canlı kurumla çalışır. Sır, kurum ve izin ortamı uyuşmazsa istek 403 INTEGRATION_ENVIRONMENT_MISMATCH alır.
  • Test olayları livemode: false taşır ve olay akışında görünmez; akış yalnız livemode: true kayıt döndürür.
  • Test ortamındaki uygulamalara gerçek GLOBAL mevzuat olayı gönderilmez.
  • Test kurumu izinlerinin iptali integration.grant_revoked olayı üretmez.
  • Test ortamında yalnız kayıtlı localhost port jokeri ek olarak desteklenir; ayrıntılar Kurum bağlantısı sayfasındadır.

Canlıya geçiş listesi

Firma yöneticisi POST /api/v1/integration-apps/{id}/request-live ile başvurur. Başvuru yalnız SANDBOX durumundaki uygulama için kabul edilir; sözleşme ve veri işleme eki kabulü ile iptal edilmiş bağlantı beyanı zorunludur. Platform incelemesi aşağıdaki yedi maddenin tamamını ister:

#Madde
1Yönlendirme, webhook ve gizlilik adresleri HTTPS ve yerel adres değil
2Webhook alıcısı geçerli imzaya 2xx, bozuk imzaya ve 6 dakika eski imzaya 4xx döner
3Test ortamında en az bir başarılı kod takası yapılmış
4Geliştirici sözleşmesi ve veri işleme eki kabul edilmiş
5Gizlilik politikası adresi HTTP 200 döner
6İptal edilmiş bağlantı için 403 yanıtının işlendiği beyan edilmiş
7Zorunlu alanlar tamam: işleme ülkesi TR, gizlilik adresi, HTTPS yönlendirme adresi veya sunucudan sunucuya beyanı, ticari unvan, 10 haneli VKN

Kişisel veri kapsamı isteyen uygulamada 7. madde ayrıca bu kapsamların hukuk doğrulamasını ister; hukuk doğrulaması kaydı yoksa madde geçmez.

Sertifikasız bağlantı tavanı

Canlıya geçmemiş uygulama en fazla 25 farklı canlı kuruma bağlanabilir; test kurumu bu sayıya girmez. Tavan dolunca yeni kurum onayı 409 Sertifikasız uygulama bağlantı tavanına ulaşıldı alır; aynı kurumun mevcut bağlantısı etkilenmez. Tavanı yalnız platform yükseltebilir; canlıya geçen uygulamaya bu tavan uygulanmaz.

Bu sayfa kapalı beta sözleşmesini anlatır; canlı ortamda genel kullanıma açıldığını göstermez.