Sosyal Giriş (Google / Apple)

Kendi Google/Apple anahtarlarınızı girersiniz; mağaza vitrininizin giriş ve kayıt sayfalarında ilgili butonlar otomatik olarak görünür. Anahtarları…

Nerede bulunur: Sol menü → Entegrasyonlar → Google Login / Apple Login Kimler için: Müşterilerinin mağazaya Google veya Apple hesabıyla tek tıkla giriş yapmasını isteyen mağazalar. Kısaca: Kendi Google/Apple anahtarlarınızı girersiniz; mağaza vitrininizin giriş ve kayıt sayfalarında ilgili butonlar otomatik olarak görünür. Anahtarları girmediğiniz sağlayıcının butonu görünmez.

Ne işe yarar?

Sosyal giriş, müşterinin e-posta ve parola girmeden Google ya da Apple hesabıyla mağazanıza kayıt olup giriş yapmasını sağlar. Bu, özellikle mobilde kayıt tamamlama oranını artırır.

Her mağaza kendi OAuth anahtarlarını kullanır. Bu sayede giriş ekranında sizin uygulama adınız görünür ve müşteri verisi doğrudan sizin sağlayıcı hesabınız üzerinden yönetilir. Client Secret ve Apple özel anahtarı şifreli saklanır ve hiçbir zaman vitrine gönderilmez; kod-token değişimi sunucu tarafında yapılır.

Dikkat: Butonların vitrinde görünmesi için ilgili entegrasyonu anahtarlarıyla birlikte kaydedip etkinleştirmeniz gerekir. Bağlama adımları için Entegrasyonları Yönetme (Liste, Kurulum, Açma/Kapama) sayfasına bakın.

Yönlendirme (redirect) adresleri

Google ve Apple, girişten sonra kullanıcıyı yalnızca önceden tanımladığınız bir adrese geri gönderir. Sağlayıcı panelinde aşağıdaki adresleri, mağaza kısa adınızı (slug) yerine koyarak tanımlayın:

Google: https://api.treyza.co/api/<mağaza-slug>/storefront/auth/social/google/callback
Apple: https://api.treyza.co/api/<mağaza-slug>/storefront/auth/social/apple/callback

İpucu: <mağaza-slug> mağazanızın adres kısmıdır (örn. magazam). Adresi birebir aynı yazın; sonundaki eğik çizgi, büyük/küçük harf farkı bile girişi engeller.

Google için

Google Cloud Console → APIs & Services → Credentials ekranından OAuth client ID oluşturun (uygulama tipi: Web application).
Authorized redirect URIs alanına yukarıdaki Google callback adresini ekleyin.
Oluşan Client ID ve Client Secret değerlerini kopyalayın.
Treyza'da Entegrasyonlar → Google Login kartını açın; iki alanı yapıştırıp kaydedin ve anahtarı etkinleştirin.

Apple için

Apple, diğerlerinden farklı olarak tek bir "secret" yerine birkaç bilgi ister. Bunları Apple Developer hesabınızdan alırsınız:

Alan	Nereden alınır
Services ID (Client ID)	Certificates, Identifiers & Profiles → Identifiers → Services IDs
Team ID	Apple Developer hesabınızın sağ üstündeki ekip kimliği
Key ID	Keys → Sign in with Apple için oluşturduğunuz anahtarın kimliği
Private Key (.p8)	Aynı anahtarı oluştururken bir kez indirilen `.p8` dosyasının içeriği

Services ID'nin Return URLs alanına yukarıdaki Apple callback adresini ekleyin ve alan adınızı Apple'da doğrulayın.
Sign in with Apple anahtarını (Key) oluşturup .p8 dosyasını indirin.
Treyza'da Entegrasyonlar → Apple Login kartını açın; Services ID, Team ID, Key ID ve .p8 dosyasının tüm içeriğini yapıştırın, kaydedip etkinleştirin.

İpucu: Apple'ın "gizli e-posta" (private relay) seçeneğinde müşteri size ...@privaterelay.appleid.com biçiminde bir adres verir. Bu adres gerçek bir gelen kutusuna yönlenir; müşteriye bu adresten e-posta gönderebilirsiniz.

Müşteri tarafında ne değişir?

Giriş ve kayıt sayfalarında, etkinleştirdiğiniz sağlayıcılara göre "Google ile devam et" / "Apple ile devam et" butonları görünür.
Müşteri bu butona tıkladığında sağlayıcıda kimlik doğrular ve mağazaya geri döner.
Sağlayıcının doğrulanmış e-postası daha önce mağazada bir hesapla eşleşiyorsa o hesaba bağlanır; eşleşme yoksa yeni bir müşteri hesabı oluşturulur.

Dikkat: Bir müşteri daha önce parolayla kayıt olduysa ve sosyal giriş için kullandığı e-posta o hesapla aynıysa, iki yöntem tek hesap altında birleşir. Güvenlik için yalnızca sağlayıcı tarafından doğrulanmış e-postalar mevcut hesaplara bağlanır.