WP Simple Pay Dokümantasyonu

WP Simple Pay için Dokümantasyon, Referans Materyalleri ve Eğitimler

Özel Alan Türleri Başvurusu

Okuma süresi: 10 dakika | Zorluk: Başlangıç

Yeni bir alan eklemek için "Bir alan seçin…" seçicisini gösteren Form Alanları sekmesi.

Genel Bakış

Form oluşturucudaki Form Alanları sekmesi, bir müşterinin ödeme formunda gördüğü ve doldurduğu öğeleri oluşturduğunuz yerdir. Bir alan seçin… seçeneğine tıkladığınızda, müşteri bilgileri, sunum öğeleri, ödeme seçimi ve gönder düğmesinin kendisini kapsayan 19 alan türü göreceksiniz.

Bu makale, her alan türü için eksiksiz bir referanstır. Özel alanların nasıl çalıştığına dair genel bir genel bakış için — ekleme, sıralama, kaldırma, gerekli olarak işaretleme — Bir Ödeme Formunun Alanları Nasıl Yapılandırılır ve Özel Veri Toplanır ile başlayın.

Ön Koşullar

  • WP Simple Pay Pro (temel bilgilerin ötesindeki özel alanlar Pro gerektirir)
  • Form düzenleyicisinde açılan bir ödeme formu

Alan Kategorileri

19 alan türü dört işlevsel gruba ayrılır:

Grup Alanlar
Müşteri bilgileri Ad, E-posta Adresi, Telefon, Adres, Vergi Kimlik Numarası, Tarih
Ödeme seçimi Fiyat Seçici, Özel Tutar Girişi, Kupon, Yinelenen Tutar Anahtarı, Ücret Kurtarma Anahtarı, Tutar Dökümü, Ödeme Yöntemleri
Form yapısı / görüntüleme Başlık, Metin, Açılır Liste, Radyo Seçimi
Gönderim tetikleyicileri Ödeme Düğmesi, Ödeme Düğmesi

Müşteri Bilgileri Alanları

Ad

Müşterinin tam adını toplar ve Stripe Müşteri kaydına kaydeder. Stripe uyumluluğu için arka planda ad/soyad olarak ayrılır.

  • Gereklilik: Kart ödemeleri, çoğu düzenleyici uyumluluk ve e-postalardaki {customer-name} gibi kullanışlı akıllı etiket değiştirmeleri için.
  • Seçenekler: Etiket, yer tutucu, gerekli anahtarı.

E-posta Adresi

Müşterinin iletişim adresi ve Stripe Müşteri e-postası olarak kullanılan e-postayı toplar. Form bir Ödeme Makbuzu gönderdiğinde her zaman gereklidir.

  • Gereklilik: Makbuzlar, Abonelikleri Yönet bağlantıları, terk edilmiş sepet kurtarma, ACH/SEPA/Bacs (Stripe bunlar için e-posta gerektirir).
  • Seçenekler: Etiket, yer tutucu, gerekli anahtarı.

Telefon

Uluslararası format desteğiyle müşterinin telefon numarasını toplar.

  • Gereklilik: SMS tabanlı onaylar, dolandırıcılık taraması, B2B formları için.
  • Seçenekler: Etiket, yer tutucu, gerekli anahtarı.

Adres

Fatura veya teslimat adresini toplar. Ülkeye duyarlı alanlar ve otomatik tamamlama ile Stripe'ın akıllı adres öğesini oluşturur.

  • Gereklilik: Vergi hesaplaması (Otomatik Vergi fatura adresi gerektirir), teslimat gerçekleştirme, dolandırıcılık kontrolleri için.
  • Seçenekler: Adres türü (Fatura veya Teslimat), etiket, zorunlu geçiş.

Vergi Kimliği

Bir işletme vergi kimliği (KDV, GST, ABN, EIN vb.) toplar ve faturalama için Stripe Müşterisine ekler.

  • Gereklidir: B2B AB faturalaması, ters kayıt KDV'si, makbuzlarda vergi kimliği basılması gereken işletmeler.
  • Seçenekler: Etiket, yer tutucu, gerekli anahtarı.

Tarih

Tarih seçici ile bir tarih değeri toplar.

  • İçin kullanışlıdır: Etkinlik kayıtları, randevu rezervasyonu, belirli bir tarihe adanmış bağışlar, “tercih edilen teslimat” tarihleri.
  • Seçenekler: Etiket, yer tutucu, zorunlu geçiş, minimum/maksimum tarih kısıtlamaları.
  • Notlar: Seçilen değer form meta verisi olarak saklanır — ücret tutarını veya Stripe faturalama döngüsünü etkilemez.

Ödeme Seçim Alanları

Fiyat Seçici

Çok fiyatlı bir formdaki en önemli ödeme alanı. Müşterinin Ödeme sekmesinde tanımladığınız fiyat seçenekleri arasından seçim yapmasını sağlar.

  • Görüntüleme Stili: Fiyatların nasıl görüneceğini seçin:
    • Temel — Düz radyo listesi (1-3 fiyat seçeneği olan formlar için varsayılan).
    • Açılır Liste — Kompakt <select> öğesi. Çok sayıda fiyatınız olduğunda ve dikey alandan tasarruf etmek istediğinizde en iyisidir.
    • Liste — Başlık, açıklama ve fiyat içeren yığılmış kartlar. Katmanlı fiyatlandırma için en iyisidir.
    • Düğmeler — Yan yana düğme grubu. Kısa, etiket tarzı seçenekler için en iyisidir (10 $, 25 $, 50 $).
  • Seçenekler: Etiket, varsayılan fiyat, zorunlu geçiş.

Özel Tutar Girişi

Müşterinin kendi tutarını girmesini sağlar — “ne kadar istersen öde” ve bağış formlarının temelini oluşturur.

  • Seçenekler: Etiket, yer tutucu, minimum tutar, maksimum tutar, varsayılan tutar.
  • İpucu: Önerilen tutarları ve bir “özel” seçeneği sunmak için bir Fiyat Seçici ile birleştirin.

Kupon

Müşterinin ödeme sırasında bir kupon kodu uygulamasını sağlar. Kuponların kendileri WP Simple Pay > Kuponlar altında yönetilir — Kupon Ekleme ve Yapılandırma bölümüne bakın.

  • Seçenekler: Etiket, yer tutucu.
  • Notlar: Genel Kuponlar yönetici sayfasından farklıdır. Alan, müşteri tarafından görülen girdidir; yönetici sayfası kupon kodlarının oluşturulduğu yerdir.

Tekrarlayan Tutar Geçişi

Müşteri tarafından etkinleştirildiğinde, tek seferlik bir ödemeyi aynı formda yinelenen bir aboneliğe dönüştüren bir onay kutusu. İki ayrı form gerektirmeden “Bunun yerine aylık bağış yap?” kalıplarını destekler.

  • Seçenekler: Etiket, faturalama aralığı (Günlük/Haftalık/Aylık/Yıllık), fatura limiti.
  • Gerektirir: Formda abonelikler etkinleştirilmiş.

Ücret Kurtarma Geçişi

Müşterinin isteğe bağlı olarak Stripe işlem ücretini karşılamasına olanak tanıyan, böylece tam olarak amaçlanan toplam tutarı almanızı sağlayan, ücreti hesaplanan bir miktarla artıran bir onay kutusu.

  • Seçenekler: Etiket, ücret yüzdesi, sabit ücret tutarı, varsayılan durum (işaretli/işaretsiz).
  • İçin kullanışlıdır: Kâr amacı gütmeyen kuruluşlar, bağış formları, B2B faturaları.

Tutar Dökümü

Ödeme toplamını listeleyen salt okunur bir görüntü alanı — satır öğeleri, vergiler, ücretler, kuponlar ve nihai tutar. Müşteri diğer alanlarla etkileşimde bulundukça canlı güncellenir.

  • Gereklidir: Vergiler özelliğini kullanarak vergi toplayan formlar — Ödemelerde Vergi Nasıl Toplanır bölümüne bakın. Bu alan olmadan, müşteriler göndermeden önce vergi satır öğesini göremezler.
  • Seçenekler: Etiket, öğe görüntüleme tercihleri.

Ödeme Yöntemleri

Müşterinin kart ayrıntılarını girdiği, alternatif bir ödeme yöntemi (ACH, SEPA, Klarna vb.) seçtiği veya kayıtlı bir yöntemi seçtiği Stripe Ödeme Öğesini oluşturur.

  • Görüntüleme Türü: Sekmeler (yatay) veya Akordeon (yığınlanmış) — Ödeme Yöntemi Görüntüleme Türü Nasıl Seçilir bölümüne bakın.
  • Görünen Öğeler: Akordeon kullanılırken, “Daha Fazla” düğmesi görünmeden önce kaç yöntemin gösterileceğini kontrol eder. Varsayılan: 5.
  • Gereklidir: Her yerinde ödeme formu için. Site dışı (Stripe Checkout) formlar bu alanı kullanmaz.

Form Yapısı / Görüntü Alanları

Başlık

Diğer alanlar arasına stilize edilmiş bir başlık ekler. İlgili alanları gruplamak için kullanışlıdır (“Fatura Bilgileri”, “Etkinlik Detayları”, “İsteğe Bağlı Ekstralar”).

  • Seçenekler: Başlık metni, başlık seviyesi (H2–H6).
  • Notlar: Tamamen görsel — herhangi bir değer toplanmaz veya Stripe'a gönderilmez.

Metin

Serbest biçimli HTML/metin için çok satırlı bir blok. Talimatlar, hizmet şartları metni, pazarlama metni veya teşekkür içeriği için kullanın.

  • Seçenekler: Gövde içeriği (HTML izin verilir).
  • Notlar: Başlık gibi, bu da yalnızca sunum amaçlıdır.

Tanımladığınız mevcut seçeneklerin bulunduğu bir <select> öğesi. Seçilen değeri, müşteri kaydında ve Stripe meta verilerinde görülebilen form meta verileri olarak depolar.

  • Seçenekler: Etiket, seçenek listesi (etiket/değer çiftleri), varsayılan seçim, gerekli anahtarı.
  • İçin kullanışlıdır: “Bizi nereden duydunuz?”, Tişört boyutu, etkinlik oturumu seçimi.

Radyo Seçimi

Dropdown ile aynı veri yapısı, ancak <select> yerine radyo düğmeleri olarak oluşturulur. 2–5 seçeneğiniz olduğunda ve hepsinin aynı anda görünmesini istediğinizde daha iyidir.

  • Seçenekler: Etiket, seçenek listesi, varsayılan seçim, gerekli anahtarı.

Gönderim Tetikleyicileri

Her formda bu iki düğme alanından tam olarak biri bulunmalıdır. Birbirini dışlarlar: (Genel sekmesinde ayarlanan) form türü, seçicide hangisinin görüneceğini belirler.

Ödeme Düğmesi

Yerinde ödeme formları (Gömülü veya Overlay) için gönderim düğmesi. Aynı sayfadaki Stripe Ödeme Öğesini kullanarak müşteriye ücret uygular.

  • Seçenekler: Düğme metni, işleme metni (istek devam ederken gösterilir).

Ödeme Düğmesi

Site dışı Stripe Checkout formları için gönderim düğmesi. Müşteriyi Stripe'ın barındırılan ödeme sayfasına yönlendirir.

  • Seçenekler: Düğme metni, işleme metni.

Sıkça Sorulan Sorular

Neden bazı formlarda Ödeme Düğmesi ve bazılarında Ödeme Sayfası Düğmesi görüyorum?

Düğme türü, Genel sekmelerindeki formun Türü ile ilişkilidir. Site içi formlar Ödeme Düğmesi kullanır; site dışı (Stripe Checkout) formlar Ödeme Sayfası Düğmesi kullanır. Genel'deki türü değiştirmek, düğme alanını otomatik olarak sizin için değiştirir.

Aynı alan türünü iki kez ekleyebilir miyim?

Bazı alanlar birden çok kez eklenebilir (Başlık, Metin, Açılır Liste, Radyo Seçimi, Tarih). Diğerleri, sabit bir rolleri olduğu için form başına yalnızca bir kez kullanılır — yalnızca bir E-posta, bir Fiyat Seçici, bir Ödeme Yöntemleri alanı, bir Kupon alanı ve bir gönder düğmesi olabilir. Seçici, zaten kullanımda olan alanları gri renkte gösterir.

Özel alanlardaki veriler nereye gidiyor?

Özel alan değerleri, Stripe Ödeme Amacı veya Aboneliği üzerindeki meta veri olarak kaydedilir. Bunları Stripe Kontrol Paneli'nde ödeme kaydının Meta Veri bölümünde ve WP Simple Pay içindeki müşteri kaydında görüntüleyebilirsiniz. Veriler ayrıca webhook'lar ve Uncanny Automator gibi entegrasyonlar için de kullanılabilir (bkz. Otomasyonlar Sekmesi Nasıl Kullanılır).

Alan değerleri makbuz e-postalarına dahil ediliyor mu?

Evet — herhangi bir özel alan değerini e-posta konularına veya gövdelerine eklemek için akıllı etiketleri kullanın. Bkz. Akıllı Etiketlerin Kullanımı.

Tutar Dökümü alanı neden boş?

Tutar Dökümü yalnızca mevcut formda bulunan kalemleri gösterir. Formunuzda vergi, ücret, girilmiş kupon yoksa ve tek bir fiyat seçeneği varsa, döküm yalnızca toplam tutara indirgenir. Detaylandırılacak bir şey olduğunda "canlanır".

Alan doğrulama kurallarını özelleştirebilir miyim?

Yerleşik alanlar mantıklı varsayılanları zorlar (E-posta bir e-posta olarak doğrulanır, Vergi Kimliği Stripe'ın kabul ettiği biçimleri kabul eder vb.). Özel doğrulama mantığı için simpay_form_validation filtresini kullanın — ancak çoğu durum yerleşik gerekli anahtarı ve alana özgü seçeneklerle karşılanır.

Sıradaki Ne Var?

Hala sorularınız mı var? Yardım etmek için buradayız!

Son Değiştirilme:

Bugün Ödeme Kabul Etmeye Başlayın

WordPress web sitenizde tek seferlik ve yinelenen ödemeleri veya bağışları kabul etmeye başlayın.