Miva için Checkout

Kaydolmadan 24 saat içinde, özel bir oryantasyon temsilcisi sizi özel bir entegrasyon süreci başlatmak için iletişime geçecektir.

Önemli: Aşağıda listelenen adımlar referans içindir ve oryantasyon temsilciniz tarafından size rehberlik edileceksiniz.

1. Modülü Miva App Store'dan indirin veya zonos.mvc dosyasını doğrudan Zonos'tan talep edin.
2. Miva yönetim panelinizde Domain Settings -> Modules -> Add Module yoluna gidin, zonos.mvc dosyasını yükleyin ve Add'e tıklayın.

3. Settings -> Modules'a gidin, Zonos'u bulun ve Install'a tıklayın. Installed olarak göründüğünü onaylayın.

Miva'da Users -> API Tokens'a gidin ve Add API Token'a tıklayın. Aşağıdaki gibi yapılandırın:

• Name: Zonos Checkout
• Allowed IP Addresses: 0.0.0.0/0, ::/0
• Signature: Require Signature with Key -- imzalama anahtarı oluşturmak için Generate'e tıklayın
• Timestamp: Require Timestamp Within 30 seconds

Sonraki ekranda, belirtecin sipariş oluşturmasına ve değiştirmesine izin vermek için Customer Service & Sales'i etkinleştirin. Save'e tıklayın.

Miva -> Utility Settings -> Zonos yoluna giderek Miva'da Checkout modülüne gidin, ardından aşağıdaki alanları doldurun:

1. Store ID: Dashboard -> Settings -> Account -> Integrations yolundan Zonos hesap numaranızı kopyalayın.
2. Zonos API Key: Gizli API anahtarınız (bunu asla paylaşmayın).
3. Zonos Public Key: Herkese açık anahtarınız.
4. Store Currency: Mağazanızın temel para birimi (örn. USD).
5. Environment: Üretim için Live, test için Test seçin.
6. Checkout Button Selector: Checkout butonunuz için CSS seçicisi (örnek: a[href*="checkout.html"]).
7. Hidden Selectors: Uluslararası müşterilerle ilgili olmayabilecek yerel ödeme seçeneklerini ve diğer ayrıntıları gizlemek için.
8. Import Orders: Tamamlanan Zonos siparişlerini Miva yönetim paneline otomatik olarak içe aktarmak için işaretleyin. Bunun için bir sonraki adımda webhook'ların kaydedilmesi gerekir.

Devam etmeden önce kaydetmek için sağ üstteki Update'e tıklayın.

Siparişler, 10.x modülünde webhook aracılığıyla içe aktarılır. Önceki modül sürümleri bunun yerine bir sipariş başarı URL'si/uç noktası kullanıyordu.

Ayarlarınızı kaydettikten sonra Register Webhooks'a tıklayın. Bu, mağazanızı Zonos'a bağlayarak tamamlanan siparişlerin otomatik olarak içe aktarılmasını, iptallerin senkronize edilmesini ve kargo güncellemelerinin Miva'ya geri gönderilmesini sağlar.

Sipariş içe aktarmanın, iptal senkronizasyonunun ve kargo güncellemelerinin çalışması için webhook'ların önce kaydedilmesi gerekir. Import Orders onay kutusu, webhook'ların kaydedilmiş olmasını gerektirir.

Kalan alanları tamamlamak için aşağı kaydırın:

1. Miva API Token: API Token oluşturun adımında oluşturduğunuz API Token'daki Access Token.
2. Miva API Signature: Aynı API Token girişindeki Signing Key.
3. Image Type: Zonos checkout'ta hangi ürün görseli boyutunun gösterileceğini seçer (çoğu mağaza için Main uygundur).
4. Additional Field Mappings: İsteğe bağlı olarak Miva özel alanlarını Zonos özniteliklerine/meta verilerine eşleyin (renk, materyal, beden vb.). Miva ürün listelerinizde ürüne özel HS kodları belirlediyseniz HS code alanını eşlemenizi tavsiye ederiz. Catalog'a girdiğiniz ürüne özel HS kodlarını kullanabildiğimiz veya varsayılan HS kodunuzu kullanabildiğimiz için bu, gümrük ve vergi teklifi oluşturmak amacıyla zorunlu değildir. Ancak yine de tavsiye edilir; doğru sınıflandırılmış ürünlerle gümrük dahil maliyet hesaplamalarının doğruluğu büyük ölçüde artacaktır. Miva'da bir alanı eşlemek için, HS kodu için özel bir alan oluşturun ve ardından Utility Settings -> Zonos altında eşleyin.

Tüm ayarları kaydetmek için Update'e tıklayın.

Hesabınızı ve modülünüzü ayarladığınıza göre, aşağıdakileri yaparak test etmeye hazırsınız:

• Test gönderim fiyatları
• Sitenizde test siparişi verin
• Sistemleriniz aracılığıyla test sipariş akışı
• Web sitenizi test edin

Bu testleri nasıl çalıştıracağınızı öğrenin. Test sırasında modülün Environment alanını Test olarak ayarlamanız gerekecektir.

Testi tamamladıktan sonra artık canlı yayına geçmeye hazırsınız! Environment'ı Live olarak ayarlayın, Zonos kimlik bilgilerinizin doğru olduğunu onaylayın ve canlı mağazanızda webhook'ların kayıtlı olduğundan emin olun.

1. dashboard.zonos.com -> Hello -> Hello Settings'e gidin.
2. Currency behavior'ı açın.
3. Ürün fiyat öğelerinizi hedefleyen CSS seçicisini girin (örn. .price).

Bu etkinleştirildiğinde Zonos Hello, fiyatları alışverişçinin yerel para biriminde otomatik olarak dönüştürüp gösterecektir.

Miva kataloğunda ayarlanan kargo boyutları, menşei ülkesi ve HS kodu otomatik olarak Zonos'a eşlenir ve doldurulmuşlarsa gümrük dahil maliyet / kargo tekliflerinde kullanılır. Yapılandırmak için ek bir eşleme gerekmez.

Mağazanız tüm varyasyonların tek bir SKU paylaştığı yapılandırılabilir ürünler satıyorsa, Miva'nın standart Product Shipping Rules özelliği ürün başına tek bir boyut kümesi depolar, bu nedenle müşterinin seçtiği şeyden bağımsız olarak her yapılandırma aynı boyutta kabul edilir.

Miva ve Zonos, varyant düzeyinde boyutları destekler, ancak bu her varyantın ayrı ayrı ayarlanmasını gerektirir. Bu, ayrık varyantlara eşlenmeyen yüzlerce veya binlerce yapılandırmaya sahip mağazalar için pratik olmayabilir.

Bu özellik, checkout sırasında yapılandırma başına boyutları doğrudan sepetten okuyarak bu sorunu çözer; bunun için mağazanızda zaten mevcut olan özel mantığı kullanır -- örneğin, boyutları ürün açıklamasından ayrıştırarak.

Gereksinimler

• Mağazanız, ürünler sepete eklendiğinde sepet öğeleri üzerinde özel boyut sütunlarını zaten doldurmalıdır (bu, Zonos modülünün kapsamı dışında, Miva tarafında yönetilir).
• Kullandığınız sütun adlarını tam olarak bilmeniz gerekir.

Yapılandırma

Bu sütun adlarını Zonos modülü yönetim panelindeki karşılık gelen üç alana girin. Standart Product Shipping Rules'a geri dönmek için bunları boş bırakın -- özellik tamamen isteğe bağlıdır ve kullanmayan mağazaları etkilemez.

Zonos Dashboard'da bir kargo etiketi oluşturulduğunda veya bir takip numarası girildiğinde, takip numarası ve gönderi durumu Miva yönetim panelindeki ilgili siparişe otomatik olarak aktarılır. Bunun için webhook'ların kaydedilmiş olması gerekir (yukarıdaki Webhook'ları kaydedin adımına bakın).

Takip bilgisi doğrudan Miva'da da girilebilir. Herhangi bir Zonos siparişinde Enter Tracking Number giriş iletişim kutusunu kullanın -- takip numarası ve gönderi durumu otomatik olarak Zonos Dashboard'a geri senkronize edilecektir.

Hata ayıklama günlüğüne Miva yönetim panelinde, Zonos modülü ayarları altından erişilebilir. Modülün işlediği her sipariş olayının -- içe aktarmalar, takip senkronizasyonları, iptaller ve Zonos'a giden iptal istekleri -- tüm yaşam döngüsünü, başarılar ve hatalar dahil olmak üzere kaydeder.

Her giriş, Zonos sipariş kimliğini, Miva sipariş kimliğini ve ilgili olduğu durumlarda Miva veya Zonos API'sinden gelen hata yanıtı gibi müşteri düzeyindeki ayrıntıları içerir. Bu, sorunları teşhis etmek için en eksiksiz bilgi kaynağı haline getirir.

Günlük yalnızca en son 500 satırı tutar. Daha eski girişler arşivlenmez, bu nedenle bir sorun oluştuktan sonra günlüğü hemen kontrol edin -- daha önceki olaylar zaten üzerine yazılmış olabilir.

Genel hata günlüğü (giriş gerekmez) 

Doğrudan bir URL üzerinden erişilebilen ikinci, herkese açık bir günlük daha mevcuttur -- Miva yönetim paneli girişi gerekmez. Yalnızca hataları kaydeder (başarıları değil) ve müşteriye ait kişisel veri veya hassas veri içermez. Hızlı tanımlama için her giriş modül sürümüyle (örn. [v10.09]) başlar.

URL biçimi:

https://[store-domain]/mm5/json.mvc?Store_Code=[miva_store_code]&Function=Module&Module_Code=igs&Session_Type=runtime&Module_Function=JSON_WebHook&publiclog=1

Örnek:

https://dts4509.mivamerchantdev.com/mm5/json.mvc?Store_Code=Test&Function=Module&Module_Code=igs&Session_Type=runtime&Module_Function=JSON_WebHook&publiclog=1

Store Code: miva_store_code, tüm dashboard siparişleri için API yanıtının metadata dizisinde döndürülür.

Tüm ödeme iadeleri doğrudan Zonos dashboard üzerinden işlenmelidir. Miva'daki Refund, Capture ve Void butonları, tasarım gereği Zonos tarafından içe aktarılan siparişler için kullanılamaz. Zonos'ta işlenen herhangi bir iade, ilgili Miva siparişindeki ödeme tutarlarını otomatik olarak güncellemez -- Miva siparişi orijinal tahsil edilen tutarları korur ve Zonos'taki iade işlemleriyle senkronize tutulmaz.

Sipariş iptalleri için davranış, siparişin geçerli durumuna bağlıdır:

• Open (henüz gönderilmemiş): Miva'da iptal edilmesi, Zonos'ta da iptal edilmesini ve ödeme yetkilendirmesinin geçersiz kılınmasını sağlar. Zonos, sipariş gönderilene kadar ödemeyi tahsil etmediğinden, müşteriden aslında hiç ücret alınmaz ve ayrı bir iade gerekmez.
• Shipped veya Completed: Miva'da iptal edilmesi, Miva siparişini iptal edilmiş olarak işaretler, ancak sipariş zaten tamamlandığından ve artık otomatik iptal için uygun olmadığından Zonos iptali reddeder. Bu durumda, siparişin Zonos'ta ele alınması gerektiğini açıklayan -- yalnızca mağaza personeli tarafından görülebilen ve müşteriye asla gösterilmeyen -- yalnızca yöneticiye özel bir not Miva siparişine eklenir. Ayrıca, satıcıyı Zonos dashboard'unda işlem yapmaya yönlendiren bir e-posta bildirimi mağaza hesabının birincil e-posta adresine gönderilir; burada uygulanabilir iadeyi manuel olarak işleyebilirler.

Belirti: Siparişler Zonos Checkout'ta tamamlanır ve Zonos dashboard'unda görünür, ancak Miva yönetim panelinde hiçbir şey görünmez.

Neden: Zonos, mağazanızın /mm5/json.mvc uç noktasına bir ORDER_CREATED webhook'u (HTTP POST) gönderir. Dev sitelerinde, sunucu düzeyindeki güvenlik genellikle bu isteği Miva'ya ulaşmadan önce engeller. Yaygın nedenler:

• HTTP Basic Auth -- Dev sitesinde bir parola istemi varsa (Plesk, cPanel, .htaccess vb.), webhook 401 Unauthorized ile reddedilir. Kimlik doğrulama istemini atlayabilmeleri için Zonos'un IP'lerini .htaccess veya Plesk yapılandırmanızda beyaz listeye alın.
• Cloudflare WAF / IP Access Rules -- Site Cloudflare üzerinden proxy'leniyorsa, güvenlik kuralları POST isteğini sunucunuza ulaşmadan önce engelleyebilir. URL yolunun /mm5/json.mvc içerdiği POST isteklerine izin veren bir WAF kuralı ekleyin veya Zonos'un IP'lerini doğrudan Cloudflare'in IP Access Rules bölümünde beyaz listeye alın.
• Sunucu düzeyinde IP izin listesi -- Dev sitesi trafiği yalnızca belirli IP'lerle sınırlıyorsa (ofis veya platform IP'lerine kilitlenmiş staging ortamlarında yaygındır), Zonos webhook istekleri hiçbir yanıt vermeden sessizce düşürülür. Tüm Zonos webhook teslimat IP'lerini sunucunuzun izin listesine ekleyin (Plesk IP Access Restriction Manager, cPanel IP Blocker veya güvenlik duvarınızın/barındırma panelinizin güvenlik kuralları).

Zonos webhook teslimat IP'leri

195.85.106.100/32
67.207.37.24/29
18.118.243.230/32
18.191.115.116/32
18.216.243.49/32
18.218.198.53/32
18.221.118.18/32
18.223.39.35/32
3.128.123.176/32
3.132.179.92/32
3.138.165.252/32
3.19.11.176/32
3.22.153.63/32
52.15.215.38/32

Bu genellikle yalnızca dev/staging sitelerini etkiler -- üretim Miva siteleri genellikle herkese açıktır ve IP beyaz listesine ihtiyaç duymaz. Bunu nasıl yapılandıracağınızdan emin değilseniz, barındırma sağlayıcınızla veya Miva desteğiyle iletişime geçin.

Ürün bilgileri, ödenmesi gereken gümrük ve vergi miktarını ve kargo maliyetini etkileyebilir. Zonos'a ne kadar çok ürün bilgisi sağlarsanız, verilen teklif o kadar kesin olacaktır. Zonos bu bilgiler mevcut olmasa bile bir teklif oluşturabilir, ancak doğruluğu iyileştirmek için aşağıdaki temel ürün ayrıntılarını sağlamanızı tavsiye eder:

• Ağırlık: Ağırlık, kargo maliyetinizi etkiler, bu da gümrük veya vergileri etkileyebilir. Miva ürün listelelerinizde yer alan ağırlıklar, mevcut olduğunda Zonos tarafından otomatik olarak kullanılır.
• Boyutlar: Boyutlar, kargo maliyetinizi etkileyebilir, bu da gümrük veya vergileri etkileyebilir. Zonos, Miva'da her ürün üzerinde ayarlanan ürün boyutlarını (uzunluk, genişlik ve yükseklik) kullanabilir, ancak uygun entegrasyon için Zonos uygulamasında eşlemeniz gerekir.
• HS kodları: HS kodları gümrük oranlarını etkiler ve bazen vergileri etkileyebilir. Zonos, Miva'daki ürün listelelerinizde ayarlanan HS kodlarını kullanabilir, ancak uygun entegrasyon için Zonos uygulamasında HS kodu alanını eşlemeniz gerekir.
• Menşei ülkesi: Bir ürünün menşei ülkesi gümrük oranlarını etkiler ve vergileri etkileyebilir. Miva, ürünlerinizin menşei ülkesini Zonos'a gönderemez, bu nedenle Zonos Kataloğu kullanılarak eklenmelidir.

Miva tarafından Zonos'a iletilen Ürün Ayrıntıları 

Not: Alternatif olarak, yukarıdaki bilgileri Kataloğa girebilir ve Miva'dan depolanan ve iletilen bilgileri geçersiz kılabilirsiniz.

Platforma göre ürün bilgileri hakkında daha fazla bilgi edinin.