SumUp'ı WebBlocks Commerce'e bağlayın

Bu kılavuz, gerçek para talep etmeden çalışan ilk SumUp sanal alan ödemesine sahip oluyor. yazılı mağaza sahipleri ve site operatörleri için. Bir ödeme formu oluşturmanıza gerek yoktur: müşteriler girer SumUp'ın barındırılan ödeme sayfasında kart bilgileri.

• an, WebBlocks Commerce eklentisini yükledi ve etkinleştirdi
• SumUp Kontrol Paneline erişim
• Ticaret Ayarlarını yönetme izni veya korumalı eklentiler ekleyebilecek bir barındırma yöneticisi ortam değişkeni geçersiz kılmaları
• Mağazanın genel HTTPS adresi
• İlk sanal alan kurulumu için yaklaşık on dakika

Sandbox ödemeleri simülasyonlardır. Gerçek parayı taşımazlar.

WebBlocks Commerce, korumalı Ticaret Ayarları formu aracılığıyla ödeme kimlik bilgilerini kabul eder. değerler kullanımda değilken şifrelenir, alanlar salt yazılır ve kaydedilen sırlar bir daha asla görüntülenmez. Hiçbir zaman bir CMS sayfasına, bloka, ürüne veya genel ayarlar alanına girilmemelidirler.

Barındırma tarafından yönetilen ortam değişkenleri, isteğe bağlı geçersiz kılmalar olarak kullanılabilir durumda kalır. API'yi göndermeyin normal e-postayı, sohbeti, ekran görüntüsünü veya destek biletini girin. Doğrudan korumalı alana girin barındırma platformunun gizli yöneticisini veya onaylanmış başka bir güvenli kanalı oluşturun veya kullanın.

1. SumUp Dashboard'da oturum açın.
2. Open Geliştirici Ayarları.
3. Korumalı Kutuları açın sekmesini açın.
4. Korumalı alan tüccarı yoksa oluşturun.
5. Korumalı alan satıcısını seçmek için hesap değiştiriciyi kullanın.

Seçilen hesap, korumalı alan olarak açıkça işaretlenmelidir. Bunun için asla canlı bir satıcı kullanmayın ilk test.

SumUp hesabınızda geliştirici ayarları veya korumalı alan seçeneği yoksa, şuradan bir geliştirici hesabı oluşturun: SumUp'ın resmi çevrimiçi ödeme testi kılavuzundaki bağlantı.

Korumalı alan satıcısı seçiliyken SumUp Kontrol Panelinin sol üst alanına bakın. Özet gösterileri hesap adı ve Merchant ID orada. WebBlocks Commerce bu değere satıcı kodu adını verir. Normalde MXXXXXXX'ye benzer.

4. Adım için bu değeri kopyalayın. Canlı hesabınızın satıcı kimliğini kullanmayın.

Korumalı alan satıcısını seçili tutun ve ardından:

1. Profilinizi genişletin ve Settings'yi açın.
2. Geliştiriciler İçin → Araç Takımı'ye gidin.
3. API Anahtarlarını açın.
4. Create'yi seçin ve anahtara tanınabilir bir ad verin; WebBlocks Commerce sandbox.
5. SumUp gösterdiğinde gizli anahtarı kopyalayın veya indirin.

SumUp Genel Anahtarını kullanmayın. WebBlocks Commerce'in sunucu tarafı gizli API anahtarına ihtiyacı var. bir test gizli anahtarı normalde sk_test_ ile başlar. SumUp sırrın tamamını bir daha göstermez, bu nedenle bunu hemen onaylı bir gizli yöneticide saklayın.

Mevcut doğrudan entegrasyon, site sahibi tarafından kontrol edilen bir satıcı hesabı içindir. OAuth: bu kurulum için gerekli değildir.

1. CMS admin'de oturum açın.
2. Ticaret → Ticaret Ayarları'nı açın.
3. Ağ geçidi SumUp'yi ve Sandbox modunu seçin.
4. Gizli API anahtarını ve Satıcı Kimliğini girin, ardından kaydedin.

Kimlik bilgisi alanları salt yazılır. Alanı boş bırakmak kayıtlı değeri korur; kullanmak yalnızca kaldırmayı düşündüğünüzde açıkça anlaşılır kontrol.

Barındırma tarafından yönetilen dağıtımlar bunun yerine şu isteğe bağlı ortam geçersiz kılmalarını ekleyebilir:

Abu değerleri barındırma platformunun ortam değişkeni veya gizli ayarlarına ekleyin:

Ortam değerleri önceliklidir ve karşılık gelen form kontrollerini salt okunur hale getirir. Eğer kurulumda bir Laravel .env dosyası kullanılıyor, değerleri buraya ekleyin. Daha sonra önbelleğe alınanları temizleyin yapılandırma:

Dağıtımınız yapılandırmayı normalde önbelleğe alıyorsa, bu önbelleği normal dağıtımını kullanarak yeniden oluşturun prosedür. Barındırma platformunuz gerektirdiğinde uzun süredir çalışan PHP çalışanlarını yeniden başlatın.

sandbox mod etiketi, operatörlerin hangi ortamın amaçlandığını görmesine yardımcı olur. SumUp bir API kullanır ana bilgisayar adı olduğundan API anahtarı ve satıcı kodunun da korumalı alan hesabına ait olması gerekir.

1. CMS admin'de oturum açın.
2. Ticaret → Ticaret Ayarları'yi açın veya şu adresi ziyaret edin: /webadmin/plugins/webblocks-commerce/settings.
3. Aşağıdakilerin tümünü doğrulayın:
   • aktif ağ geçidi: sumup
   • varsayılan para birimi: EUR (veya SumUp tarafından desteklenen başka bir para birimi)
   • Toplam modu: sandbox
   • API anahtarı: yapılandırılmış
   • tüccar kodu: yapılandırılmış
   • ödeme: hazır
   • eklenti şeması: hazır

Ayarlar ekranında kasıtlı olarak yalnızca "yapılandırılmış" veya "eksik" yazıyor. API'yi asla görüntülemez Başarılı bir kaydetme sonrasında da dahil olmak üzere anahtarın kendisi.

Şema hazır değilse Sistem → Eklentiler → WebBlocks Commerce'yi açın ve eklenti kurulumunu çalıştırın veya önce geçişler.

1. Commerce → Ürünler'yi açın.
2. Bir ürün oluşturun veya düzenleyin.
3. Bir başlık, bilgi, fiyat, para birimi ve vergi sınıfı ayarlayın.
4. Korumalı alan satıcısı para birimi seçicide gösterilen başka bir seçeneği kullanmadığı sürece ilk SumUp testi için EUR'yi seçin.
5. Ürün durumunu Active olarak ayarlayın.
6. Ürünü kaydedin.

A taslak veya arşivlenmiş ürün teslim alınamıyor. Takip edilen stok etkinse en azından bir ünite mevcuttur.

1. Sayfa oluşturucuda istediğiniz CMS sayfasını açın.
2. Normal bir sayfa yuvasına bir Commerce Satın Alma Düğmesi bloğu ekleyin.
3. Aktif ürünü seçin.
4. Düğme etiketini, hizalamayı ve fiyat görüntüleme seçeneklerini seçin.
5. Sayfayı normal CMS iş akışı aracılığıyla önizleyin ve yayınlayın.

Güvenilen bir HTML bloğu kullanmayın ve bir Özet ödeme URL'sini içeriğe yapıştırmayın. Bir ödeme URL'si her sipariş için oluşturulur ve yaklaşık 30 dakika sonra sona erer.

1. Genel ürün sayfasını veya Ticaret düğmesini içeren sayfayı açın.
2. AÜrünü sepete ekleyin.
3. Miktarı, KDV'yi, para birimini ve son tutarı kontrol edin.
4. 'yi seçinÖdemeyi güvenli hale getirmeye devam edin.
5. SumUp tarafından barındırılan sayfada şu resmi sanal alan test kartını kullanın:

1. Ödemeyi tamamlayın ve mağazaya geri dönmek için iade işlemini kullanın.
2. CMS yöneticisinde Commerce → Siparişler'yi açın.
3. Siparişin paid olarak değiştiğini ve ödeme girişiminin succeeded olarak değiştiğini onaylayın.

Tarayıcı dönüş sayfası ödeme kanıtı değildir. Sipariş ancak WebBlocks tarihinden sonra ödenir Commerce, SumUp bildirimini alır, ödemeyi SumUp'tan alır ve satıcı, referans, tutar, para birimi, son durum ve başarılı işlem.

Bu entegrasyon için SumUp Dashboard'da webhook URL'si oluşturmayın veya yapıştırmayın. WebBlocks Commerce bu geri aramayı otomatik olarak ödeme return_url olarak gönderir:

Genel mağaza HTTPS kullanmalı ve SumUp bu URL'ye erişebilmelidir. Güvenlik duvarı, bakım sayfası, HTTP kimlik doğrulaması veya proxy kuralı SumUp'ın POST isteğini engellememelidir.

SumUp'ın korumalı alanı, reddedilen bir ödemeyi simüle etmek için belirli toplamları kullanır. Arıza yolunu test etmek için, son ödeme toplamı tam olarak 11.00 EUR olan geçici bir ürün oluşturun, ardından bir korumalı alan kullanın test kartı. Siparişin ödendi olarak işaretlenmediğini ve rezerve edilen stoğun, sipariş tarihinden sonra serbest bırakıldığını onaylayın. hata işlendi.

Bu test için gerçek bir ürünün fiyatını değiştirmeyin.

Yalnızca korumalı alan akışının tamamı başarılı olduktan sonra geçiş yapın:

1. SumUp Dashboard'da gerçek satıcı hesabını seçin.
2. SumUp'ın gerektirdiği tüm işletme doğrulama ve ödeme kurulumlarını tamamlayın.
3. Canlı Satıcı Kimliğini kopyalayın.
4. Ayrı bir canlı gizli API anahtarı oluşturun. Canlı anahtar normalde sk_live_ ile başlar.
5. Kaydedilen sanal alan değerlerini Ticaret Ayarları'de değiştirin, modu Live olarak değiştirin ve kaydedin. Barındırma tarafından yönetilen dağıtımlar bunun yerine ortam geçersiz kılmalarının yerini alabilir:

1. Ortam geçersiz kılmaları kullanılıyorsa normal dağıtım prosedürünü kullanarak uygulama yapılandırmasını yenileyin.
2. Ticaret Ayarlarını Yeniden Kontrol Edin.
3. Kabul edilebilir düşük değerli bir gerçek satın alma işlemi yapın ve her iki sistemde de siparişi ve ödemeyi doğrulayın.

Bir test anahtarını asla canlı bir satıcı kimliğiyle birleştirmeyin veya korumalı alan anahtarını üretimde yeniden kullanmayın.

• Salt yazılır alanına API anahtarını yeniden girin ve kaydedin.
• Bir ortam geçersiz kılma gösteriliyorsa, yazımını kontrol edin ve dağıtımın veya PHP işleminin yenilendiğini onaylayın.
• Yapılandırma önbelleğe alınmışsa, normal dağıtım prosedürünü kullanarak temizleyin ve yeniden oluşturun.

• Anahtarın ve satıcı kimliğinin aynı korumalı alan hesabına ait olduğunu onaylayın.
• Anahtarın genel anahtar değil, gizli API anahtarı olduğunu onaylayın.
• Ürünün aktif olduğunu, fiyatının olumlu olduğunu ve stokta mevcut olduğunu onaylayın.
• Ürün para biriminin satıcının desteklediği para birimiyle eşleştiğini doğrulayın.

• https://your-shop.example/plugins/webblocks-commerce/webhooks/sumup'ye POST yoluyla herkesin erişebileceğini onaylayın HTTPS.
• Bir güvenlik duvarı, bakım sayfası veya HTTP parolasının geri aramayı engellemediğini kontrol edin.
• API anahtarının ödemeyi hâlâ alabileceğini ve yapılandırılan satıcıya ait olduğunu onaylayın.
• Confirm SumUp, ödemeyi başarılı bir işlemle PAID olarak bildirir.

Sepetten ödeme işlemini tekrar başlatın. Barındırılan ödeme oturumlarının süresi yaklaşık 30 dakika sonra dolar. yapma Barındırılan eski bir ödeme URL'sine yer işareti koyun veya yeniden kullanın.

• API anahtarını asla bir CMS bloğuna, sayfasına, ürününe, tarayıcı komut dosyasına, veri havuzuna, ekran görüntüsüne veya destek günlüğü.
• Asla sohbete gerçek bir API anahtarı yapıştırmayın.
• Korumalı alanı ve canlı kimlik bilgilerini ayrı tutun.
• Anahtarın açığa çıkmış olma ihtimali varsa, anahtarı derhal iptal edin ve değiştirin.
• Tarayıcı başarı ekranını değil, CMS sipariş durumunu yerine getirme sinyali olarak değerlendirin.

Mimari, web kancası doğrulaması, sipariş durumları ve gelişmiş sorun giderme için şu adresle devam edin: WebBlocks Commerce Operatör Kılavuzu.

Resmi Özet referansları:

• Çevrimiçi ödemeleri test etme
• API anahtarlarını oluşturun ve koruyun
• Barındırılan Ödeme
• Ödeme durumu web kancaları