Kullanıcıya Özel Checkout Link Yaratma
API ile checkout link oluşturma hakkında bilgi edinin
Bu API hizmeti, Zotlo ile oluşturulan checkout link’inin özelleştirilmesine ve kullanıcıya özel bir bağlantı yaratılmasına olanak tanır.
Zotlo paneli üzerinden oluşturduğunuz checkout linkini, kullanıcıya özel hale getirmek isterseniz; formdaki görsel, metinler, para birimi ve fiyat gibi alanları düzenleyerek bu işlemi gerçekleştirebilirsiniz.
Checkout Link Özelleştirme API’si, POST metodu ile çalışır.
URL
https://api.zotlo.com/v2/app-to-web/one-link
İstek Parametreleri
applicationKey: Projeye veya servise özel olarak
verilen key bilgisidir. Proje>Developer Tools>
Checkout SDK alanından görüntülenebilir.
subscriberIpAddress : Abonenin işlem
yaptığı anda kullandığı IP adresidir.
language: Kullanıcının tercih ettiği dil bilgisidir.
Default olarak EN gönderilebilir.
checkoutLinkId: Özelleştirme yapılacak checkout link id'sidir. Bu bilgiye erişebilmek için önce Zotlo Panel'de bir checkout Link oluşturulması gerekir.
Örnek İstek:
Checkout Link oluşturma servisine istek gönderirken gerekli olan Access Key,Access Secret ve App Id bilgilerine, Zotlo Panel'de yer alan Developer Tools/API Keys sayfasından ulaşabilirsiniz. İstekte yer alan Application Key bilgisine ise Developer Tools/Checkout SDK sayfasından ulaşabilirsiniz.
{
"applicationKey": "989e9bc1fbbbc1b82e18548c4577ed3f24c9dc39cc416db5",
"subscriberId": "",
"subscriberIpAddress": "37.24.56.13",
"language": "en",
"productImage": "",
"additionalText": "Zotlo Test",
"checkoutLinkId": "123",
"packageName": "Package Name Test",
"customPrice": "",
"customCurrency": "",
"customParameters": {
"mmp": {
"appsflyer_id": "id6446176688",
"idfa": "B8292198-C43D-88B6-C0ABC8478E21"
}
}
}Not: Yaratılan checkout linklerin expire süresi 1 saattir ve eğer bu süre içinde başarılı ödeme alınırsa tekrar linklere erişim sağlanamaz.
İstek Parametreleri:
İstek Parametreleri:
Açıklama
Zorunlu mu?
applicationKey
Projeye veya servise özel olarak verilen key bilgisidir. Proje>Developer Tools>Checkout SDK alanından görüntülenebilir.
✔
subscriberId
Aboneyi tanımlayan benzersiz kullanıcı ID'sidir. Telefon numarası,E-mail, Apple Relay e-mail formatında ya da UUid v4 formatında olabilir. Eğer Apple Relay Email veya UUid v4 formatında gönderilirse formda zorunlu olarak e-mail istenir.
✖
subscriberIpAddress
Abonenin işlem yaptığı anda kullandığı IP adresidir. Fiyat ve consent gösterimi gibi akışların başlangıcı için zorunludur.
✔
language
Kullanıcının tercih ettiği dil bilgisidir. Gönderilen dile göre form içerikleri değişir. Default olarak EN gönderilebilir.
✔
productImage
Satışa sunulan paketi temsil eden görsel URL’idir.Eğer boş gönderilirse bu alan gizlenir.
✖
additionalText
Kullanıcıya gösterilecek olan ek bilgi alanıdır. Bu alanın fiyat bilgisi default olarak 0.00 setlenir. Genellikle gösterilecek Bonus veya İndirim metni için kullanılır. Eğer boş gönderilirse bu alan gizlenir.
✖
checkoutLinkId
Özelleştirme yapılacak checkout link id'sidir. Bu bilgiye erişebilmek için önce Zotlo Panel'de bir checkout Link oluşturulması gerekir.
✔
packageName
Kullanıcıya gösterilecek olan isimdir. Eğer boş gönderilirse bu alan gizlenir.
✖
customPrice
Kullanıcıya gösterilecek özel fiyat bilgisidir. Sadece tek seferlik ödemeler için eklenen paketin fiyatı bu alan ile ezilebilir. Eğer boş bırakılmışsa kullanıcı IP’sine göre eklenen paketteki fiyat gösterimi yapılır.
✖
customCurrency
Para birimi bilgisidir. Eğer boş bırakılırsa kullanıcı IP’sine göre eklenen paketteki fiyat gösterimi yapılır.
✖
customParameters
Uygulamaya ya da kullanıcıya özel parametreler burada gönderilebilir. Adjust veya Appsflyer için event gönderimini Zotlo yapacaksa mmp parametresi ile aşağıdaki alanlar gönderilebilir. "mmp": {
"appsflyer_id": "",
"oaid": "",
"androidId": "",
"gpsAdid": "",
"idfv": "",
"fireAdid": "",
"adid": "",
"idfa": "",
"osVersion": ""
}
✖
Başarılı Cevap Örneği
{
"meta": {
"requestId": "68b5fbdd6f-hpwjc-REQ-683dbb1c4c569",
"httpStatus": 200
},
"result": {
"oneLink": "https://checkout.zotlo.com/payment/6e7ac760800a071338d6b81b9dc65b9ffbbdd18de17e4cb9a1"
}
}Başarısız Cevap Örneği
Servislerimizden HTTP status code olarak başarılı durumlarda 200 dönmektedir. Başarısız durumlarda ise 400 ya da 500 Http StatusCode dönmektedir. Örnek hata cevabı aşağıdaki şekildedir.
{
"meta": {
"requestId": "core-backend-68b5fbdd6f-hpwjc-REQ-683dc0ef3d027",
"httpStatus": 400,
"errorMessage": "The checkoutLinkId is required.",
"errorCode": "400079"
},
"result": []
}Başarısız Cevap Parametreleri:
Başarısız dönen isteklerde yer alan parametreler aşağıdaki gibidir. Başarısız isteklerde hata kodu olarak 400 ya da 500 dönmektedir.
requestId
Alınan hatanın detayıdır. Hata mesajı, gönderdiğiniz dil parametresine göre her dile özel verilmektedir.
httpStatus
İlgili cevaba ait HttpStatus kodudur. Standart kodlar olan, 400 ya da 500 dönmektedir.
errorMessage
Alınan hatanın detayıdır.
errorCode
İlgili hatanın Zotlo'daki hata kodudur. Zotlo'da her hataya özel tekil hata kodları yer almaktadır. Aşağıdaki hata kodlarını alabilir.
404001 : Geçersiz endpoint
401002: AccessKey, AccessSecret parametreleri hatalı.
400008: subscriberId parametresi hatalı.
400009: Kullanıcı profili bulunamadı.
500000: Sunucu hatası.
400079: Paket Id’si girmek zorunludur.
result
Bu alanın alabileceği değer dinamik olarak değişebilir. Hata durumunda ilgili servisten bir cevap dönerken dolu olarak gelebilir. Aksi durumda ise boş bir obje olarak dönebilir.
Last updated