Özel entegrasyon

Başlamak için, bir hesap oluşturmak ve bir anlaşma imzalamak amacıyla lütfen satış ekibimizle iletişime geçin. Bir anlaşma imzalandıktan sonra, doğrulanması gereken hesabınıza iki mikro depozit alacaksınız.

Lütfen bu mikro depozit tutarlarını accounting@zonos.com adresine Dashboard mağaza kimliğiniz ile e-posta gönderin (satış temsilcinizi CC'ye alın).

Doğrulanma tamamlandıktan sonra, banka bilgileriniz Dashboard -> Settings -> Billing sayfasında görüntülenecektir.

Zonos hesabınızı oluşturduktan sonra, Checkout'un mağazanızla düzgün çalışmasını sağlamak için Dashboard'da ayarları yapılandırmanız gerekecektir. Bu bölüm tüm temel Dashboard yapılandırmalarını kapsamaktadır.

Ödemeleri ayarlayın 

Checkout'tan zamanında ödeme almak için bir banka hesabı bağlayın. Ödemeler, yakalanan ödemeden itibaren 2 günlük bir gecikmeyle günlük olarak işlenir. Bunu yapmak için lütfen şu adımları izleyin:

1. Dashboard -> Settings -> Checkout settings sayfasına gidin.
2. Add bank account (Banka hesabı ekle) seçeneğine tıklayın
3. Kurulumu tamamlamak ve aşağıdaki bilgileri sağlamak için bir Stripe portalına yönlendirileceksiniz:
   • Banka hesabı bilgileri.
   • Şirket EIN'i.
   • %25 şirket sahibinin Sosyal Güvenlik Numarası. Bunun neden gerekli olduğu hakkında daha fazla ayrıntı için Stripe'ın belgelerine bakın.

Not: Ödeme programınızı güncellemeniz gerekiyorsa, lütfen support@zonos.com ile iletişime geçin

İzin verilen etki alanlarını ayarlayın 

Zonos JS betiği, güvenlik amacıyla izin verilen etki alanlarının bir listesini gerektirir. Bu, yetkisiz sitelerin betiği yüklemesini önler ve yalnızca onaylı etki alanlarınızda çalıştığından emin olur. Bu yapılandırma olmadan, betik izin hataları döndürecektir.

Bunu kurmak için:

1. Dashboard -> Settings -> Checkout settings sayfasına gidin
2. URLs bölümünde Checkout'un kullanılacağı tam etki alanınız ve alt etki alanlarınızı ekleyin. Örneğin, etki alanınız example.com ise, example.com ve test.example.com eklemelisiniz.

Markalaşma ayarlarını özelleştirin 

Dashboard'da markalaşma ayarlarınızı mağazanızın görünüş ve hissiyatıyla eşleşecek şekilde yapılandırın.

Bunu yapmak için lütfen şu adımları izleyin:

1. Dashboard -> Settings -> Checkout settings -> Branding sayfasına gidin
2. Aşağıdaki ayarları yapılandırın:
   • Logo.
   • Marka ve vurgu rengi.
   • Tema, Stil ve Yazı Tipi.

Markalaşma ayarları hakkında daha fazla bilgi için belgelerimize bakın.

Bir kargo taşıyıcısını bağlayın 

Checkout'ta kargo fiyatı sağlamak için, Zonos hesabınıza bir kargo taşıyıcısı bağlamanız gerekecektir. Bu, checkout'ta belirli kargo hizmet seviyelerini etkinleştirmenizi sağlayacaktır.

Bir kargo taşıyıcısını bağlamak için, lütfen şu adımları izleyin:

1. Dashboard -> Settings -> Shipping -> Rates sayfasına gidin
2. Add carrier (Taşıyıcı ekle) seçeneğine tıklayın
3. Taşıyıcı kurulum talimatlarını izleyin.

Taşıyıcı hesaplarını bağlama hakkında daha fazla ayrıntı için belgelerimize bakın.

Kargo bölgelerini ayarlayın 

Kargo bölgeleri, dünyanın farklı bölgeleri için hangi kargo taşıyıcılarının ve hizmet seviyelerinin kullanılabilir olduğunu yapılandırmanıza izin verir.

Kargo bölgelerini ayarlamak için, lütfen şu adımları izleyin:

1. Dashboard -> Settings -> Shipping -> Locations sayfasına gidin
2. New zone (Yeni bölge) seçeneğine tıklayın
3. Bir bölge adı girin ve göndermek istediğiniz ülkeleri seçin.
4. Sunmak istediğiniz taşıyıcı ve hizmet seviyesini seçin.

Kargo bölgeleri hakkında daha fazla ayrıntı için belgelerimize bakın.

Yedek menşe ülkesini ve HS kodunu ayarlayın 

Menşe ülkesi ve HS kodu, doğru gümrük ve vergileri hesaplamak için kullanılır.

Belirli bir menşe ülkesi veya HS kodu sağlamazsanız, Dashboard'da ayarlanan yedekleri kullanacağız.

Yedek Menşe Ülkesi ve HS kodunu ayarlamak için:

1. Dashboard -> Settings -> Shipping -> Catalog sayfasına gidin.
2. Menşe ülkesi için, ürünlerinizin çoğunluğunun üretildiği ülkeyi seçin.
3. HS kodu için, en yaygın ürününüzün HS kodunu girin. HS kodunuz yoksa, Dashboard'da Classify sayfasına gidin ve ürünün adını ve açıklamasını girerek doğru bir HS kodu oluşturun.

Zonos JS snippet'i, sitenizde küresel checkout işlevselliğini etkinleştiren istemci tarafı JavaScript entegrasyonudur. E-ticaret platformunuz ve Zonos hizmetleri arasında köprü görevi görür ve şunları işler:

• Checkout Deneyimi: Checkout kullanıcı arayüzünü oluşturur ve ödemeleri işler.
• Konum Hizmetleri: Ziyaretçi konumunu algılar ve para birimi dönüşümünü yönetir.
• Sepet Entegrasyonu: Mevcut sepet ve sipariş sisteminiz ile bağlanır.
• Güvenlik: Etki alanlarını doğrular ve API isteklerinin kimliğini doğrular.

Snippet, sitenizin performansı üzerinde hiçbir olumsuz etki olmaksızın asenkron olarak yüklenir. Mağazanızın API kimlik bilgileriyle başlatılır ve tüm istemci tarafı etkileşimlerini güvenli bir şekilde işler. Uygulama, müdahaleci olmayacak şekilde tasarlanmıştır ve mevcut checkout akışında minimum değişiklik gerektirir.

Aşağıda, Checkout'u entegre ederken referans alabilmek için betik yükleme, başlatma ve olay işlemeyi içeren kapsamlı bir örnek verilmiştir.

4. Rölenin hangi mülk/piksel için tetikleneceğini bilmesi için ilgili kimliklerini Checkout customHTML aracılığıyla geçirin:

Adım adım iframe talimatları, tam olay referansı (purchase / Purchase yük eşlemesi dahil) ve hata ayıklama ipuçları için bkz.:

• Google Analytics 4 for iframe Checkout
• Facebook Pixel for iframe Checkout

Siparişlerinizi sisteminiz ile Zonos Dashboard arasında senkronize etmek için şu API çağrılarını ve webhook'ları uygulayın:

Gerekli Mutasyonlar 

Gerekli Webhooks 

Checkout entegrasyonunuz ile canlı olmadan önce, sorunsuz bir müşteri deneyimi sağlamak için entegrasyonun tüm yönlerini iyice test etmek önemlidir. Buna checkout akışı, ödeme işleme, sipariş oluşturma ve webhook işlevselliğinin test edilmesi dahildir.

Test rehberimizi izleyin entegrasyonunuzun düzgün çalıştığını doğrulamak ve üretim ortamında başlatmadan önce sorunları belirlemek ve gidermek için.

Entegrasyon süreci hakkında sık sorulan sorular aşağıdadır.

Zonos, sipariş onayını nasıl işler? 

Dashboard -> Settings -> Checkout settings sayfasında Success page type altında satın alma sonrası deneyimini yapılandırın. Üç seçenek kullanılabilir:

• Show Zonos success page (varsayılan, önerilen) — Zonos, sipariş verilmesinin ardından yerleşik bir teşekkür sayfası görüntüler. Sayfa her zaman gösterilir, hatta sipariş sisteminize aktarılamasa bile, bu nedenle alıcı her zaman bir onay alır.
• Redirect to a success page — Zonos, kısa bir "Order complete" ekranında bekler, ardından yapılandırılan başarı URL'nize zOrderNumber (ve eski sepetler için orderId) sorgu parametreleri eklenerek yönlendirir.
• Close the checkout modal — Zonos, ödeme yakalandıktan sonra modal'ını kapatır. Ayrıca bir başarı URL'si yapılandırırsanız, Zonos, siparişin oluşturulması için beklemeden — Stripe ödemeyi topladıktan sonra hemen başarı URL'nize yönlendirir ve zonosCheckoutSessionId'yi sorgu parametresi olarak ekler. Bu seçeneği, kendi başarı sayfanıza en hızlı geçişi istediğinizde kullanın.

zonosCheckoutSessionId'den siparişi arama 

Close the checkout modal seçeneğini yönlendirme URL'si ile kullandığınızda, yeniden yönlendirmeden sonra siparişin checkout oturumuna eklenmesi birkaç saniye sürebilir. URL'den zonosCheckoutSessionId okuyun ve gizli kimlik bilgisi belirteci kullanarak sunucunuzdan checkoutSession GraphQL sorgusunu siparişin hazır olması için yoklayın. Bunu tarayıcıdan asla çağırmayın — gizli kimlik bilgisi belirteci sunucu tarafında kalmalıdır.

Sorguyu, Dashboard -> Settings -> Integrations sayfasından aldığınız gizli kimlik bilgisi belirtecinizi credentialToken istek başlığı olarak geçirerek https://api.zonos.com/graphql adresine gönderin.

Bir siparişin oluşturulduğu zaman haberdar edilebilir miyim? 

Evet. Bir sipariş oluşturulduğunda bildirim almak istiyorsanız, Dashboard'da Checkout settings sayfasının Email bölümünde, bir siparişin oluşturulduğu, gönderildiği veya iptal edildiği zaman bildirilmesi gereken ekip üyelerinin e-posta adresini girebilirsiniz.