Tekrarlayan müşterilerin bilgilerini Zonos Checkout'a önceden yükleyin.
Müşteri profilleri, hesabı olan müşterilerin adreslerini ve ödeme bilgilerini önceden yüklemelerine izin vererek ödeme deneyiminizi kolaylaştırır.
Bu özellik şu anda yalnızca özel API entegrasyonları için kullanılabilir. Bu özellik henüz Checkout eklentilerini kullanan satıcılar için kullanılabilir değildir.
Yeniden satıcılara, devlet kurumlarına veya kâr amacı gütmeyen kuruluşlara satış yapıyorsanız, vergi muafiyeti sertifikalarını da bir müşteri profiline senkronize edebilirsiniz.
1
Kimliği doğrulanmış müşteri bilgisi gönderin
Bir müşteri profilinin kimliğini doğrulamak için, arka uç sunucunuz daha iyi performans için paralel olarak çalıştırmanızı önerdiğimiz iki bağımsız API çağrısı yapmalıdır:
createCart: Zonos sepetini oluşturur. Ayrıntılı rehberlik için özel entegrasyon belgelerinde Zonos Checkout Kurulumu bölümüne bakın.
checkoutCustomerProfileAuthenticate: Müşterinin bilgisini gönderir ve doğrular.
Müşteri oturumunu doğrularken, istekte ilettiğiniz customerId değerinin doğru profille eşleştiğinden emin olun, böylece ödeme sırasında doğru müşteri bilgisi görüntülenir. Bir sepet oluştururken, customerId değerini meta verilere dahil etmemelisiniz çünkü üzerine yazılacaktır.
Müşteri kimliği doğrulandıktan ve sipariş verildikten sonra, sipariş sorgusu aracılığıyla sipariş ayrıntıları alınırken order.references içinde customerId kullanılabilir olacak, bu da siparişi doğru müşteri ile ilişkilendirmenize izin verecektir.
2
Müşteri profiliyle sepet oluştur
Her iki mutasyonu da çağırdıktan sonra, aşağıdakini geri alacaksınız:
createCart mutasyonundan sepeti oluşturmak için cartId.
Müşteri kimlik doğrulaması için checkoutCustomerProfileAuthenticate mutasyonundan bir oneTimePassword.
Checkout'ta sağlanan müşteri profili bilgisini yüklemek için bu değerlerin her ikisini de Zonos.init işlevindeki createCartId geri aramasına geçirebilirsiniz.
Müşteri bilgisini ilk kez gönderdiğinizde, Zonos sağlanan müşteri bilgisini saklayacaktır. Ödeme yöntemleri Stripe'da güvenli bir şekilde saklanacaktır. Yeni adres veya ödeme yöntemi ayrıntıları her iletildiğinde, bunlar müşterinin profiline eklenecektir.
Adresler ve ödeme yöntemleri yalnızca eklenebilir—mevcut olanlar düzenlenemez veya kaldırılamaz. Bir müşterinin adı, e-postası ve telefonu checkoutCustomerUpsert ile güncellenebilir.
checkoutCustomerProfileAuthenticate, o ödeme oturumu için tek kullanımlık bir şifre ürettiğinden, alıcının hazır bulunmasını gerektirir. Bir ödeme işlemi dışında profil oluşturmak veya güncellemek istediğinizde — müşteri listenizi önceden yüklemek, kendi sisteminizden profil değişikliklerini senkronize etmek veya bir müşterinin ilk siparişinden önce vergi muafiyetlerini eklemek gibi durumlarda — bunun yerine checkoutCustomerUpsert kullanın.
customerId üzerinden eşleştiği için, tekrar tekrar çağırmak yinelenen kayıtlar oluşturmak yerine aynı profili günceller. Programlı olarak tüm müşteri listeniz genelinde çalıştırmak güvenlidir.
Güncellemelerin nasıl uygulandığı hakkında bilmeniz gereken üç şey:
Atlanan alanlara dokunulmaz. Yalnızca name göndermek adı günceller, e-posta ve telefonu ise olduğu gibi bırakır.
Değerler temizlenemez. Boş bir değer göndermek, alanı atlamakla aynı şekilde ele alınır, bu nedenle bir kez ayarlandıktan sonra adı, e-postayı veya telefonu kaldırmanın bir yolu yoktur.
Adresler yalnızca eklenir. Profilde zaten var olan bir konum yinelenmez ve istekte yer almayan konumlar kaldırılmaz.
checkoutCustomerUpsert, bir oneTimePassword döndürmez. Bir profili Checkout'a yüklemek için
yine de o oturum için bir tane üreten checkoutCustomerProfileAuthenticate'e ihtiyacınız vardır.
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Müşteri profilleri
Müşteri profilleri
Tekrarlayan müşterilerin bilgilerini Zonos Checkout'a önceden yükleyin.
Müşteri profilleri, hesabı olan müşterilerin adreslerini ve ödeme bilgilerini önceden yüklemelerine izin vererek ödeme deneyiminizi kolaylaştırır.
Bu özellik şu anda yalnızca özel API entegrasyonları için kullanılabilir. Bu özellik henüz Checkout eklentilerini kullanan satıcılar için kullanılabilir değildir.
Yeniden satıcılara, devlet kurumlarına veya kâr amacı gütmeyen kuruluşlara satış yapıyorsanız, vergi muafiyeti sertifikalarını da bir müşteri profiline senkronize edebilirsiniz.
Kimliği doğrulanmış müşteri bilgisi gönderin
Bir müşteri profilinin kimliğini doğrulamak için, arka uç sunucunuz daha iyi performans için paralel olarak çalıştırmanızı önerdiğimiz iki bağımsız API çağrısı yapmalıdır:
createCart: Zonos sepetini oluşturur. Ayrıntılı rehberlik için özel entegrasyon belgelerinde Zonos Checkout Kurulumu bölümüne bakın.checkoutCustomerProfileAuthenticate: Müşterinin bilgisini gönderir ve doğrular.mutation checkoutCustomerProfileAuthenticate($input: CheckoutCustomerProfileAuthenticateInput!) {checkoutCustomerProfileAuthenticate(input: $input) {emailcustomerIdorganizationIdnamephonelocations {administrativeAreacountryCodelocalityline1line2postalCode}oneTimePassword}}Müşteri oturumunu doğrularken, istekte ilettiğiniz
customerIddeğerinin doğru profille eşleştiğinden emin olun, böylece ödeme sırasında doğru müşteri bilgisi görüntülenir. Bir sepet oluştururken,customerIddeğerini meta verilere dahil etmemelisiniz çünkü üzerine yazılacaktır.Müşteri kimliği doğrulandıktan ve sipariş verildikten sonra, sipariş sorgusu aracılığıyla sipariş ayrıntıları alınırken
order.referencesiçinde customerId kullanılabilir olacak, bu da siparişi doğru müşteri ile ilişkilendirmenize izin verecektir.Müşteri profiliyle sepet oluştur
Her iki mutasyonu da çağırdıktan sonra, aşağıdakini geri alacaksınız:
createCartmutasyonundan sepeti oluşturmak içincartId.Müşteri kimlik doğrulaması için
checkoutCustomerProfileAuthenticatemutasyonundan bironeTimePassword.Checkout'ta sağlanan müşteri profili bilgisini yüklemek için bu değerlerin her ikisini de
Zonos.initişlevindekicreateCartIdgeri aramasına geçirebilirsiniz.Zonos.init({...checkoutSettings: {...createCartId: async () => {const result = await fetch('https://api.merchant.com/api/get-cart-info',{body: JSON.stringify(payload),method: 'POST',},);const json =await result.json();return {cartId: json.cartId,customerAuthenticationToken:json.customerProfileAuthenticate?.checkoutCustomerProfileAuthenticate.oneTimePassword ||'',};}},}Müşteri profillerini yönet
Müşteri bilgisini ilk kez gönderdiğinizde, Zonos sağlanan müşteri bilgisini saklayacaktır. Ödeme yöntemleri Stripe'da güvenli bir şekilde saklanacaktır. Yeni adres veya ödeme yöntemi ayrıntıları her iletildiğinde, bunlar müşterinin profiline eklenecektir.
Adresler ve ödeme yöntemleri yalnızca eklenebilir—mevcut olanlar düzenlenemez veya kaldırılamaz. Bir müşterinin adı, e-postası ve telefonu
checkoutCustomerUpsertile güncellenebilir.Bir alıcı olmadan profil oluşturma veya güncelleme
checkoutCustomerProfileAuthenticate, o ödeme oturumu için tek kullanımlık bir şifre ürettiğinden, alıcının hazır bulunmasını gerektirir. Bir ödeme işlemi dışında profil oluşturmak veya güncellemek istediğinizde — müşteri listenizi önceden yüklemek, kendi sisteminizden profil değişikliklerini senkronize etmek veya bir müşterinin ilk siparişinden önce vergi muafiyetlerini eklemek gibi durumlarda — bunun yerinecheckoutCustomerUpsertkullanın.mutation checkoutCustomerUpsert($input: CheckoutCustomerProfileInput!) {checkoutCustomerUpsert(input: $input) {customerIdemailnamephonelocations {administrativeAreacountryCodeline1line2localitypostalCode}}}customerIdüzerinden eşleştiği için, tekrar tekrar çağırmak yinelenen kayıtlar oluşturmak yerine aynı profili günceller. Programlı olarak tüm müşteri listeniz genelinde çalıştırmak güvenlidir.Güncellemelerin nasıl uygulandığı hakkında bilmeniz gereken üç şey:
namegöndermek adı günceller, e-posta ve telefonu ise olduğu gibi bırakır.checkoutCustomerUpsert, bironeTimePassworddöndürmez. Bir profili Checkout'a yüklemek için yine de o oturum için bir tane üretencheckoutCustomerProfileAuthenticate'e ihtiyacınız vardır.CheckoutCustomerProfileInput
checkoutCustomerUpsert
Bu sayfa faydalı mıydı?