ApivomApivom
Demo Alın

Stripe API Bağlayıcısı

Apivom Iris'ten Stripe'ın barındırılan Checkout'uyla ödeme alın: bir ödeme kaydı Checkout Oturumuna dönüşür, müşteri Stripe'ın sayfasında öder, durum ve iadeler geri senkronize olur, imzalı webhook'lar zamanlanmış otomasyonla mutabık kılınır — kendi gizli anahtarınızla, Apivom üzerinden kart verisi geçmeden.

Neler yapabilirsiniz

  • Iris ödeme kaydından doğrudan barındırılan Checkout Oturumu oluşturun; müşteri Stripe'ın sayfasında öder
  • Iris'ten durum senkronizasyonu ve iade; webhook'lar (Stripe-Signature, 5 dakika tolerans) zamanlanmış olarak mutabık kılınır
  • Tasarım gereği SAQ-A: ham kart uç noktaları (/v1/tokens, /v1/payment_methods) katalog dışıdır
  • Canlı veya test modu anahtar ön ekiyle seçilir (sk_live_ / sk_test_) — aynı bağlantı, aynı temel URL
  • 585 kataloglanmış rota (262 salt okunur): müşteriler, faturalar, abonelikler, ödemeler, bakiye, itirazlar ve daha fazlası merkezden denenebilir

Kullanım senaryoları

  • Anlaşmadan ödeme bağlantısı gönderin — Bir fırsata veya faturaya bağlı ödeme kaydından Checkout Oturumu oluşturun ve Stripe'ın barındırılan sayfasını paylaşın; müşteri ödediğinde kayıt kendini günceller.
  • CRM'den çıkmadan iade yapın — Tahsil edilmiş bir ödemede Iris'ten tam veya kısmi iade başlatın; nihai durumu ve Stripe ücretini webhook mutabık kılsın.
  • Canlıya geçmeden tüm akışı test edin — Önce bir test anahtarı bağlayın, Stripe test kartlarıyla gerçek Checkout Oturumları çalıştırın ve muhasebe onayladığında canlı anahtara geçin — başka hiçbir şey değişmez.

Stripe REST API, çevrimiçi ödemelerin fiilî standardıdır: ödeme niyetleri, Checkout Oturumları, müşteriler, faturalar, abonelikler, iadeler, ödemeler ve arkalarındaki bakiye. Apivom Iris bunu CRM'in para tarafı için bir ödeme geçidi olarak kullanır. Bir ödeme kaydından operatör barındırılan bir Checkout Oturumu oluşturur; müşteri ödemeyi Stripe'ın kendi sayfasında tamamlar, böylece hiçbir kart numarası Apivom'a dokunmaz ve entegrasyon en hafif PCI kapsamında (SAQ-A) kalır — katalog Stripe'ın ham kart uç noktalarını bilerek dışarıda bırakır. Stripe webhook'ları kiracı bazlı bir alıcıya gelir, uç noktanın imza anahtarıyla beş dakikalık tolerans içinde doğrulanır ve zamanlanmış otomasyonla mutabık kılınır; durum değişiklikleri ve iadeler yoklama olmadan ödeme kaydında görünür. Canlı ve test aynı bağlantıdır: anahtar ön eki karar verir. Checkout akışının ötesinde, 585 kataloglanmış rotanın herhangi biri Iris entegrasyon merkezinden bir yönetici tarafından saklanan anahtarla çalıştırılabilir; her çağrı kiracınızda kaydedilir.

Kimlik doğrulama

Stripe gizli anahtarınız (sk_live_… veya sk_test_…) her istekte Bearer olarak gönderilir; mod ön eke göre belirlenir. İsteğe bağlı webhook imza anahtarı (whsec_…) yalnızca Iris'in Stripe-Signature doğrulaması içindir. İkisi de Iris kiracınızda şifrelidir; Apivom Atlas hiçbir şey saklamaz.

Sık sorulan sorular

Apivom üzerinden kart verisi geçer mi?

Hayır. Ödemeler Stripe'ın barındırılan Checkout sayfasında alınır ve katalog, ham kart numarası kabul edecek uç noktaları (POST /v1/tokens, /v1/payment_methods) dışarıda bırakır. Apivom yalnızca Stripe'ın nesne kimliklerini ve durumlarını görür.

Webhook'lar nasıl güvence altına alınır, biri kaçarsa ne olur?

Her kiracının kendi alıcı URL'si vardır; Stripe'ın Stripe-Signature başlığı uç noktanızın imza anahtarıyla doğrulanır (ham gövde üzerinde HMAC-SHA256, 5 dakika tolerans). Olaylar saklanır ve zamanlanmış otomasyonla mutabık kılınır; geciken veya yeniden denenen bir olay sırayla ve bir kez uygulanır.

Iris'ten Checkout dışındaki Stripe nesnelerini kullanabilir miyim?

Evet — müşteriler, faturalar, abonelikler, ödemeler, bakiye hareketleri ve 585 kataloglanmış rotanın geri kalanı bir yönetici tarafından entegrasyon merkezinden çağrılabilir (okumalar doğrudan, yazmalar onay arkasında). Bugün otomatik akışlar Checkout Oturumları, durum senkronizasyonu, iadeler ve webhook'lar için mevcuttur.

Apivom bu bağlayıcı için API çağrısı başına ücret alır mı?

Hayır. Bağlayıcılar Apivom kiracınızın parçasıdır ve Atlas portalında ölçümlenmez. Bağladığınız hesapta sağlayıcının kendi fiyatlandırması, kotaları ve hız sınırları geçerli olmaya devam eder — Apivom çağrılarını bu sınırların içinde kalacak şekilde hızlandırır ve her çağrıyı kiracınızın entegrasyon günlüğünde gösterir.

Kimlik bilgilerim nerede saklanır, trafiği kim görür?

Apivom Atlas durumsuz bir geçittir: sağlayıcı kimlik bilgilerini veya jetonları asla saklamaz. Bağlanan Apivom ürünü kimlik bilgisini kiracı veritabanınızda şifreli tutar; her istek ve yanıt yalnızca kiracınızda kaydedilir — verileriniz kiracılar arasında asla paylaşılmaz.

Diğer Atlas entegrasyonları

AI entegrasyon rehberi (llms.txt)

Makine tarafından okunabilir markdown — AI asistanınıza entegrasyon talimatı olarak verin.