Login SDK

Gereklilikler

Login Page URL Cname Yönlendirmesi

İşlemlere başlamadan önce kullanılacak login page URL’inin Cname olarak lcname.zotlo.com adresine yönlendirilmesi gerekmektedir.

JavaScript Dosyasının Eklenmesi

Zotlo Web SDK ile kullanıcıların login işlemini gerçekleştirebilmek için aşağıdaki örnekte olduğu gibi ilgili javascript dosyasının login ekranına eklenmesi gerekmektedir.

<script type="text/javascript" src="https://cdn.zotlo.com/tr/sdk.js?publicKey=yourPublicKey"></script>

Login Butonun Oluşturulması

JavaScript dosyasını ekledikten sonra sayfanıza ekleyeceğiniz login butonunu aşağıdaki yöntemlerle oluşturabilirsiniz:

• Login butonunu manuel olarak oluşturmak isterseniz html sayfanıza ekleyeceğiniz buton elementinin onclick event’ine aşağıdaki örnekte olduğu gibi ”Zotlo.login()” eklemelisiniz.

<button type=button" onclick=Zotlo.login();">SMS ile Giriş Yap

• Login butonunu otomatik olarak oluşturmak isterseniz html sayfanıza aşağıdaki div elementini eklemeniz gerekmektedir.

<div class="zotlo-login-buttons"></div>

JavaScript Kodunu Ekleyin

Yukarıdaki adımlardan bir tanesi ile login butonunuzu oluşturduktan sonra aşağıdaki JavaScript kodunun sayfanıza eklenmesi gerekmektedir:

<script>
Zotlo.init({
publicKey: '',
redirectUrl:'',
loginButton: true
});
</script>

publicKey	Bu alana uygulamanıza ait API public key gelecektir.
redirectUrl	Bu alana uygulamanızda tanımladığınız geri dönüş adresiniz gelecektir.
loginButton	“true” olarak tanımlanırsa login butonu otomatik olarak oluşacaktır. * zotlo-login-button şeklinde bir div elementinin sayfaya eklenmiş olması gerekmektedir.

Kullanıcılar “SMS ile Giriş Yap” butonuna tıkladıklarında pop-up içerisinde doğrulama ekranları açılır ve doğrulama işlemleri tamamlandığında “Zotlo.init” içerisine tanımlanan redirectUri adresine abonelik bilgilerini alabilmek için bir token değeri GET metodu ile gönderilir.

RedirectUri adresinize gelen token değeri ile uygulamanıza ait Access Key ve Access Secret bilgilerini purchaseList API endpoint’ine istek atarak kullanıcının faydasının olup olmadığı kontrol edilebilir.

Access Key ve Access Secret bilgileri Zotlo onboarding ekibi tarafından iletilecektir.

Geliştirme

Uygulama içerisinde webhooklar tanımlanmış ise düzenli olarak kullanıcıların fayda durumu takip edilebilir ve güncellemeler alınabilir. Webhooklar tanımlanmamış ise kullanıcıların fayda durumu her login işlemindede uygulama tarafına iletilecektir. Login durumunda olan ve faydaları bitmiş olan kullanıcıların session yönetimi uygulama tarafında yapılmalıdır.

Örnek Request

curl --location --request GET 'https://api.zotlo.com/v1/purchase/list?token=***' \
--header 'AccessKey: ***' \
--header 'AccessSecret: ***' \
--header 'ApplicationId: **' \
--header 'Language: tr'

Başarılı Sonuç

"meta": {
"requestId": "7198eab26992-REQ-60c0e6f255d65",
"httpStatus": 200
},
"result": [
{
"status": "active",
"realStatus": "active",
"subscriberId": "***",
"subscriptionType": "trial",
"startDate": "2021-05-27 14:44:46",
"expireDate": "2021-06-03 14:44:46",
"package": "aff.test",
"language": "tr",
"country": "TR",
"phoneNumber": null,
"originalTransactionId": "82d75b63-ee6a-41dd-a195- 2d3adbd8459f",
"cancellation": null,
"quantity": 1,
"pendingQuantity": 0,
"customParameters": []
}
]
}

Başarısız Sonuç

{
"meta": {
"requestId": "app2.localdomain-REQ-5e7db66e67542",
"httpStatus": 400,
"errorMessage": "Kullanc abonelik profili bulunamadı.",
"errorCode": 400009
},
"result": []
}