Stripe
Stripe hesabını Era’nın ödeme akışına bağla; müşterinin Checkout ekranı ile tahsilat sonucu ayrı adımlardır.
Stripe hesabını Era’nın ödeme akışına bağla; müşterinin Checkout ekranı ile tahsilat sonucu ayrı adımlardır.
Nerede kullanılır
Webde Ayarlar → Uygulamalar → Yüklü uygulamalar (/settings/apps) bağlantıları yönetir; Uygulamalar (/apps) yeni bağlantı içindir. Era Desktop: İşletme → Uygulamalar ve Ayarlar → Uygulamalar → Yüklü uygulamalar.
Bağlantı için gerekenler
| Alan | Ne girilir |
|---|---|
| Secret key (sk_…) | Gerekli. Gizli bağlantı değeri. |
| Webhook signing secret (whsec_…) | Gerekli. Gizli bağlantı değeri. |
Adım adım bağla
Anahtarları bağla
Uygulamalar → Stripe ekranındaki bağlantı formunu doldur; anahtarları yalnız bu forma gir.
Ödeme ayarını aç
Ayarlar → Ödemeler (/settings/payments) ekranında bağlı hesabı seç ve test modunu kullan.
Sağlayıcı dönüşünü ayarla
Aşağıdaki teknik bölümde belirtilen webhook/callback yolunu sağlayıcı hesabında yapılandır.
Sonucu kontrol et
Kontrollü test ödemesinin Finans kaydına sonucuyla geldiğini kontrol et; müşterilere sunma ve sıralamayı ayrıca kaydet.
Era ve iş akışı işlemleri
Aşağıdaki adlar mevcut workflow bloğundaki işlemlerdir. Akışta bağlı hesabı ve her işlem için istenen kayıt kimliklerini seç; bir işlemi listelemek onun kendiliğinden çalışması değildir.
Yerleşik ödeme ayarı finance.configure_payment_app aksiyonudur. Tahsilat/iade durumu sağlayıcının doğrulanmış sonucuyla güncellenir; hesap bağlamak ödeme olayı üretmez. Kullanılabilir ödeme aksiyonları için Finans rehberini aç.
Tetikleyiciler
| Tetikleyici | Ne zaman başlar |
|---|---|
stripe_webhook | Stripe workflow webhook teslimatı; ödeme callback’inden ayrı kurulur. |
İzinler ve sınırlar
Bağlamadan önce
Merkezî uygulama tanımı Stripe için Era araç listesi ilan etmez. Workflow Stripe bloğu ayrıca API key isteyen ödeme, müşteri, abonelik ve fatura araçları taşır; ödeme formuna girilen secretKey’nin bu bloğa otomatik aktarıldığını varsayma. Canlı tahsilat doğrulanmış webhook sonucuyla izlenir.
Uygulamalar için okuma hesabı görme, yönetme bağlantı/ayar düzenleme, silme kaldırma hakkıdır. Gelen Kutusu kanal yönetimi için Gelen Kutusu yönetme; ödeme ayarları için Finans yönetme izni gerekir. İş akışları ve Era ayrıca hedef modülün izinlerine uyar.
İlgili modüller
Era’ya söyle
Stripe ile alınan ödemeleri Finans kayıtlarından göster.
Gerekli hesabı ve hedef kaydı belirt. Era bağlı hesabın erişimi ve rolünün izinleriyle çalışır; örnek bir komut işlemin başarıyla tamamlandığı anlamına gelmez.
Teknik ekipler için
POST /api/pay/stripe/webhook ödeme sağlayıcısının dönüş yolu; workflow webhook’u farklıdır. Çalışma alanı, kayıtlı ödeme referansından bulunur; imza bağlı hesabın anahtarıyla doğrulanır.
Kod kaynakları: apps/studio/lib/integrations/definitions.ts, apps/studio/app/(app)/apps/components/connect-app.tsx, apps/studio/blocks/blocks/stripe.ts, packages/os-kernel/src/integrations/catalog.ts.