Papara iFrame API ile bir eklentı/ödeme modülü geliştiriyorum. Entegrasyon gereksinimleri, sandbox/test erişimi ve linkleme (tek link vs. birden fazla link) konularında netleşmem gereken noktalar var. Ayrıca test profillerine girişte sorun yaşıyorum.
Kullanım senaryosu:
-
Kullanıcılar sitem/uygulamam üzerinden Papara ile ödeme yapacak.
-
Akışta Papara’nın iFrame’i kullanılacak; kullanıcı sayfadan çıkmadan işlemi tamamlayacak.
-
Eklenti; {Platform/Çatı: örn. WooCommerce/Shopify/Custom} üzerinde çalışacak.
Teknik Çevre:
-
Frontend: {React/Vue/Vanilla JS}, Backend: {Node/PHP/.NET/…}
-
Alan adı(ları): {example.com, staging.example.com}
-
Sunucu ortamı: {Prod/Staging bilgisi}
-
Planlanan callback/webhook URL’ler: {https://example.com/papara/callback, https://example.com/webhook/papara}
Sorularım
-
iFrame API erişimi & dokümantasyon
-
iFrame temelli entegrasyon için resmi dokümantasyon/örnek repo var mı?
-
iFrame içinde desteklenen event’ler (ör.
postMessage) ve önerilen entegrasyon modeli nedir?
-
-
Sandbox / Test ortamı
-
Sandbox erişimi nasıl talep ediliyor? Onay süreçleri neler?
-
Test ödemeleri için test profilleri veya dummy hesaplar sağlanıyor mu? Varsa kimlik bilgileri/akış nasıl?
-
-
Test profillerine giriş sorunu
-
Şu an test login ekranına erişirken sorun yaşıyorum.
-
Test ortamında login için tek bir ortak link mi veriliyor yoksa ayrı linkler (örn. merchant/partner bazlı) mi kullanılıyor?
-
Erişimde domain ya da IP kısıtı var mı?
-
-
Alan adı whitelisting / CSP
-
iFrame için allowed origin listesi gerekiyor mu?
-
Content-Security-Policyayarları için önerilen direktifler var mı?
-
-
Yönlendirme & geri dönüş akışı
-
iFrame akışında redirect/callback URL zorunlu mu?
-
Başarılı/Başarısız durumları yakalamak için en doğru yöntem nedir (event, webhook, query param, vb.)?
-
-
Webhook’lar ve durum yönetimi
-
Ödeme durum güncellemeleri için webhook uç noktaları mevcut mu?
-
Yeniden deneme (retry), imza/doğrulama ve idempotency ile ilgili beklentiler nelerdir?
-
-
Linkleme (tek link vs. çoklu link)
-
iFrame akışında tek bir ödeme linki üzerinden mi ilerleniyor yoksa her işlem için dinamik link üretmek mi gerekiyor?
-
Linklerin süre/tek-kullanımlık gibi kısıtları var mı?
-
-
Hata kodları & rate limit
-
iFrame/arka planda dönen hata kodları listesi ve açıklamaları var mı?
-
Rate limit değerleri ve limit aşımlarında beklenen davranış nedir?
-
-
Güvenlik & uyumluluk
-
iFrame kullanan entegrasyonlarda PCI kapsamı nasıl etkileniyor?
-
Ek güvenlik tavsiyeleri (ör. CSRF/token, referrer policy) var mı?
-
-
Dil/yerelleştirme & UI
-
iFrame dilini ayarlamak mümkün mü (TR/EN vb.)?
-
Marka özelleştirmesi (logo/renk) destekleniyor mu?
-
-
Ücret/komisyon ve test
-
Test ortamında komisyon simülasyonu yapılıyor mu?
-
Canlıda komisyon hesaplaması için örnek senaryo/doküman var mı?
-
-
Destek & SLA
- Entegrasyon sürecinde teknik destek iletişim kanalı ve tipik SLA nedir?
