Stripe

Stripe'ı salt okunur kısıtlı bir anahtarla bağlayın, ardından yeni ödemelerin hemen görünmesi için bir webhook ekleyin.

RevGlance, Stripe hesabınızı sizin oluşturduğunuz bir anahtarla Stripe'ın API'si üzerinden okur. Ödemeleri, iadeleri, komisyonları, itirazları ve abonelikleri okur; asla ödeme almaz, iade yapmaz veya hiçbir şeyi değiştirmez.

Başlamadan önce

RevGlance'ta işletmenin sahibi veya yöneticisi olmanız gerekir. Görüntüleyiciler kaynak ekleyemez.
Gizli anahtarınız yerine bir kısıtlı anahtar kullanın. RevGlance ikisini de kabul eder (rk_… veya sk_…), ancak kısıtlı bir anahtar yalnızca izin verdiğiniz şeyleri okuyabilir.
Test modu anahtarları da çalışır; ilk bakış için kullanışlıdır. Hazır olduğunuzda canlı anahtarınızla ikinci bir kaynak bağlayın.

Bağlama

Stripe Dashboard'da Developers › API keys bölümünü açın ve Create restricted key seçeneğini seçin. Adını RevGlance koyun.
Anahtara Balance, Charges, Customers, Disputes, Invoices, Checkout Sessions, Subscriptions ve Coupons için Read erişimi verin. Diğer her şeyi None olarak bırakın.
Anahtarı oluşturun ve kopyalayın. rk_live_ ile başlar.
Anahtarı Kısıtlı anahtar altına yapıştırın ve Bağla: Stripe seçeneğini seçin. İlk eşitleme tüm geçmişinizi okur.

Formun istedikleri

Alan	Örnek
Kısıtlı anahtarŞifreli saklanır	`rk_live_…`

Ad alanı isteğe bağlıdır. Bir işletmedeki iki Stripe hesabını birbirinden ayırır.

Webhook'u ekleyin

Webhook olmadan RevGlance, Stripe'ı her saat eşitler. Webhook ile yeni bir ödeme, iade veya iptal saniyeler içinde bir eşitlemeyi kuyruğa alır.

RevGlance'ta Ayarlar › Kaynaklar bölümünü açın, Stripe kaynağını bulun, menüsünü açın ve Webhook seçeneğini seçin. URL'yi kopyalayın.
Stripe'ta Developers › Webhooks bölümünü açın ve bu URL ile bir endpoint ekleyin.
Rakamlarınızı değiştiren olayları seçin: charge.succeeded, charge.failed, charge.refunded, charge.dispute.closed, customer.subscription.created, customer.subscription.updated, customer.subscription.deleted ve invoice.paid. Herhangi bir olay işe yarar: her biri yalnızca bir eşitleme başlatır.
Endpoint'in signing secret değerini (whsec_…) kopyalayın, RevGlance'ta İmzalama gizli anahtarı altına yapıştırın ve kaydedin.

RevGlance neleri eşitler

Bakiye işlemleri: Stripe'ın kapattığı para biriminde her ödeme, iade, itiraz ve Stripe komisyonu.
Başarısız ödemeler metriği ve Kurtar için başarısız ödemeler.
MRR, planlar, denemeler ve iptaller için müşterileri, kalemleri, indirimleri ve en son faturalarıyla birlikte her durumdaki abonelikler. Stripe'ın iptal nedeni ve müşterinin yorumu, Stripe'ta varsa bunlarla birlikte gelir.

İlk eşitleme tüm geçmişinizi okur. Bundan sonra her eşitleme, geç gelen değişiklikleri yakalamak için son eşitlemeden üç gün öncesinden itibaren okur ve abonelikler her seferinde tamamen okunur.

Stripe nasıl sayılır

Ödemeler, iadeler ve Stripe komisyonları, Stripe'ın mutabakat yaptığı para biriminde bakiye işlemlerinizden gelir.
Kart iadeleri, Stripe'ın kaydettiği gün sayılır. Banka ödemeleri (ACH, SEPA ve diğer yerel yöntemler) de sayılır; bankanın geri gönderdiği bir iade, iadelerinizi yeniden düşürür.
Bir itiraz, Stripe parayı geri aldığında iade olarak sayılır ve itirazı kazanırsanız iade iptal edilir. Stripe'ın itiraz ücreti komisyon olarak tutulur.
Abonelikteki ve tek tek kalemlerdeki kuponlar MRR'dan düşülür. Sabit tutarlı bir kupon yalnızca kendi para biriminde sayılır.
Duraklatılmış ve ödenmemiş abonelikler kayıp sayılır; vadesi geçmiş bir abonelik, Stripe kartı yeniden denerken sayılmaya devam eder.
Ödemeler, iadeler ve itirazlar, faturalarındaki veya Checkout Session'larındaki vergi oranıyla vergi öncesi sayılır. Checkout Sessions için okuma erişimi olmadan, fatura dışı satışlardaki vergi dahil kalır.
Vergi dahil bir fiyat, son faturadaki vergi oranıyla MRR'da vergi öncesi sayılır.
Ödeme tahsilatının duraklatılması, Stripe buna tarih vermediği için RevGlance'in onu ilk gördüğü günden itibaren kayıp sayılır.

Her sağlayıcı için geçerli kurallar için bkz. Nasıl sayıyoruz.

Kurtarma e-postaları

Kurtar, başarısız bir abonelik ödemesini Stripe'taki açık fatura sayfasına bağlar; müşteri orada yeni bir kartla ödeme yapabilir. Açık fatura yoksa bunun yerine bir Stripe müşteri portalı oturumu açar. Bu yedek yol için portalın Stripe'ta açık olması ve anahtarın Customer portal oturumları yazmasına izin verilmesi gerekir; bu yoksa e-posta sizin kendi kart güncelleme sayfanıza bağlanır.

Sorun giderme

"Bir Stripe gizli veya kısıtlı anahtarı yapıştırın." Anahtar rk_ veya sk_ ile başlamalıdır. Yayınlanabilir bir anahtar (pk_) hiçbir şey okuyamaz.
"Stripe refused that key." Anahtar iptal edilmiş veya Balance için okuma erişimi yok.
"Stripe refused the failed-charge request" veya "the subscription request": anahtar Charges veya Subscriptions okuyamıyor. Ödemeler yine eşitlenir; eksik izni ekleyin ve yeniden eşitleyin.