Entegrasyonlar
Bağla: Stripe
Müşterilerin faturaları Stripe hesabın üzerinden çevrimiçi öder; VentionDesk ödemeyi kaydeder.
Nereden bağlanır
VentionDesk'te Operasyon › Kaynaklar › “Kaynak ekle” altında, kategori Ödeme, ardından Stripe. Bağlama, düzenleme ve kaldırma işlemlerini yalnızca işletme sahibi yapabilir.
Adım adım
- Stripe'ta Developers › API keys altında “VentionDesk” adlı kısıtlı bir anahtar oluştur. Tam olarak şu izinlere ihtiyacı var, geri kalan her şey “None” kalır: Checkout Sessions: Write (ödeme sayfasını oluşturur); PaymentIntents: Read (bir iadeden önce neyin hâlâ açık olduğunu kontrol eder); Charges: Read (orada zaten neyin iade edildiğini okur); Refunds: Write (VentionDesk'ten iadeler).
- Anahtarı buraya gir ve kaydet. VentionDesk onu checkout oturumlarını sorgulayarak kontrol eder; hiçbir şey tahsil edilmez. Bir test anahtarına (rk_test_…) izin verilir: Bu durumda faturada yalnızca test bağlantısı olur, e-posta ve fatura belgesi bağlantısız kalır.
- Ardından “Kaynaklar” › Stripe altında “Webhook adresini göster”e tıkla ve onu Stripe'ta Developers › Webhooks › “Add endpoint” altında tam olarak şu olaylarla ekle: checkout.session.completed, checkout.session.async_payment_succeeded, checkout.session.async_payment_failed, charge.refunded.
- Endpoint'in “Signing secret”ını (whsec_…) kopyala ve bağlantıyı anahtar ve signing secret ile yeniden kaydet. Ödeme bağlantısı fatura e-postasında ve belgede ancak o zaman görünür: Webhook olmadan bir ödeme, VentionDesk onu kaydetmeden gelirdi.
- Para senin Stripe hesabına gider. VentionDesk her ödemeyi ve her iadeyi faturaya karşı kaydeder ve Stripe'a yalnızca fatura numarasını, tutarı ve müşterinin e-posta adresini gönderir.
İletişim kutusunun istedikleri
| Alan | Bilgi | Nereden |
|---|---|---|
| Kısıtlı anahtar | Zorunlu | gizli | Developers › API keys › “Create restricted key” (rk_live_… veya rk_test_…). Bir secret key (sk_…) da çalışır, ama her şeyi yapabilir. |
| Webhook signing secret | isteğe bağlı | gizli | Endpoint oluşturulduktan sonra Developers › Webhooks › endpoint'in › “Signing secret” altında gösterilir (whsec_…). Boş bırakmak öncekini korur. |
VentionDesk gizli bilgileri şifreli saklar ve bir daha asla göstermez. Ancak sağlayıcı erişimi onayladığında kaydedilirler; bir bağlantıyı düzenlerken gizli bir alanı boş bırakırsanız önceki değer korunur.
Tüm sağlayıcılar bir bakışta: EntegrasyonlarWebhook URL'leri: Webhook'lar