Müşteri profilleri

Bir müşteri profilini kimlik doğrulamak için, arka uç sunucunuzun iki bağımsız API çağrısı yapması gerekir; bunları daha iyi performans için paralel olarak çalıştırmanızı öneririz:

• createCart: Zonos sepetini oluşturur. Ayrıntılı rehberlik için, özel entegrasyon belgelerindeki Set up Zonos Checkout section bölümüne bakın.

• checkoutCustomerProfileAuthenticate: Müşterinin bilgilerini gönderir ve doğrular.

mutation checkoutCustomerProfileAuthenticate(
    $input: CheckoutCustomerProfileAuthenticateInput!
  ) {
  checkoutCustomerProfileAuthenticate(input: $input) {
    email
    customerId
    organizationId
    name
    phone
    locations {
      administrativeArea
      countryCode
      locality
      line1
      line2
      postalCode
    }
    oneTimePassword
  }
}

{
	"input": {
		"email": "test@zonos.com",
		"locations": [
			{
				"administrativeArea": "BC",
				"countryCode": "CA",
				"line1": "411-1033 Davie Street",
				"line2": "123 testAddress2",
				"locality": "Vancouver",
				"name": "TestCanada TestCanada",
				"postalCode": "V6E1M7"
			},
			{
				"administrativeArea": "UT",
				"countryCode": "US",
				"line1": "411-1033 Davie Street",
				"line2": "123 testAddress2",
				"locality": "Saint George",
				"name": "TestUS TestLastName",
				"postalCode": "84770"
			}
		],
		"customerId": "1234567",
		"name": "testFirstName1 testLastName",
		"phone": "7022920000"
	}
}

Müşteri oturumunu doğrularken, istekte geçirdiğiniz customerId'nin doğru profille eşleştiğinden emin olun, böylece checkout'ta doğru müşteri bilgilerini görüntüleyebilirsiniz. Bir sepet oluştururken, customerId'yi meta verilerde dahil etmemeye dikkat edin, çünkü bu değer üzerine yazılacaktır.

Müşteri kimlik doğrulandıktan ve sipariş verildikten sonra, order.references içinde customerId sipariş detaylarını almak için sipariş sorgusu aracılığıyla mevcut olacak ve bu sayede siparişi doğru müşteriyle ilişkilendirebileceksiniz.

Her iki mutasyonu çağırdıktan sonra, aşağıdakileri alacaksınız:

• Sepeti oluşturmak için createCart mutasyonundan cartId.

• Müşteri kimlik doğrulaması için checkoutCustomerProfileAuthenticate mutasyonundan bir oneTimePassword.

Bu iki değeri, sağlanan müşteri profili bilgilerini Zonos'ta yüklemek için Checkout.init fonksiyonundaki createCartId geri çağrısında 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 bilgilerini ilk kez gönderdiğinizde, Zonos sağlanan müşteri bilgilerini saklayacaktır. Ödeme yöntemleri güvenli bir şekilde Stripe'ta saklanacaktır. Yeni adres veya ödeme yöntemi bilgileri her iletildiğinde, bunlar müşterinin profiline eklenecektir.

Şu anda, müşteri profilleri yalnızca ek bilgilerle güncellenebilir—mevcut bilgiler düzenlenemez veya kaldırılamaz.