Satış Adedi Güncelleme
Zotlo ile aboneliklerinizi yönetin
Bu özellik, bir pakete ait faturalandırılan satış adedinin güncellenmesini sağlar. Toplam tutarın adet bazlı hesaplandığı fiyatlandırma modelleri için tasarlanmıştır.
Seat bazlı SaaS ürünleri, lisans bazlı satışlar veya paket bazlı modeller bu kullanım senaryolarına örnek verilebilir. Bu modellerde toplam tutar, birim fiyat × satış adedi formülüne göre hesaplanır.
Satış Adedi Değişiklik Kuralları
Yeni gönderilen değer mevcut satış adedinden yüksek ise, artan satış adedi için mevcut yenileme periyodunun sonuna kadar ek ücret tahsil edilmeye çalışılır. Ödeme işlemi başarılı olursa satış adedi hemen güncellenir.
Yeni gönderilen değer mevcut satış adedinden düşük ise, güncelleme hemen uygulanmaz. Güncellenen satış adedi bir sonraki yenileme döneminde geçerli olur.
Method
POST
İstek Parametreleri
Örnek İstek
Ödeme İşlemleri Raporu 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. Bu bilgileri isteğin header'ında göndermeniz gerekmektedir.
POST https://api.zotlo.com/v1/subscription/change-quantity HTTP/1.1
AccessKey: ••••••
AccessSecret: ••••••
Content-Type: application/json
ApplicationId: •
Language: ••
{
"subscriberId":"[email protected]",
"packageId":"zotlo.premium",
"quantity":2
}Başarılı Cevap Örneği
Başarılı Cevap Parametreleri
The parameters included in the successful response are as follows.
status
Abonelik durumunu belirtir. Aşağıdaki değerleri alabilir:
active : Kullanıcı haklarını kullanmaya devam edebilir.
passive : Kullanıcının hakları sona ermiştir.
grace : Paket yenileme işlemi yapılamamış, ancak kullanıcı belirli bir süre boyunca haklarını kullanmaya devam edebilir.
realStatus
Abonenin gerçek durumunu verir. Eğer kullanıcının hesabı bir şekilde iptal olduysa passive döner. Status değerinden farklı, status kullanıcının son kullanma tarihi gelene kadar active dönmeye devam edecektir.
active : Kullanıcı haklarını kullanmaya devam edebilir.
passive : Kullanıcının hesabı bir şekilde iptal olmuş demektir. Status değerinden farklıdır. Status, kullanıcının son kullanma tarihi gelene kadar active dönmeye devam edecektir.
subscriptionType
Kullanıcının aboneliğinin durumunu belirtir. Aşağıdaki değerleri alabilir:
trial ise abone henüz deneme süresi içerisindedir.
paid ise kullanıcı ücretli süreye geçmiş ve en az bir kere paket ücreti çekilmiş demektir.
startDate
Aboneliğin başladığı tarih bilgisidir.
expireDate
Abonelik bitiş tarihidir. Bu tarihte abonelik yenileme işlemleri yapılır.
package
İşlemin yapılacağı paket bilgisidir.
country
Kullanıcının ülke bilgisidir.
language
Kullanıcının dil bilgisidir.
quantity
Pakete ait aktif ve faturalandırılan mevcut satış adedini ifade eder.
pendingQuantity
Bir sonraki yenileme döneminde geçerli olacak planlanan satış adedini ifade eder.
Yeni gönderilen quantity değeri mevcut değerden düşük ise, güncelleme hemen uygulanmaz ve güncellenen satış adedi pending.quantity alanında saklanır.
Belirtilen satış adedi, bir sonraki yenileme döneminde otomatik olarak aktif hale gelir.
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.
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
Zotlo tarafından üretilen ve saklanan benzersiz istek parametresidir.
httpStatus
İlgili cevaba ait HttpStatus kodudur. Standart kodlar olan, 400 ya da 500 dönmektedir.
errorMessage
Alınan hatanın detayıdır. Hata mesajı, gönderdiğiniz dil parametresine göre her dile özel verilmektedir.
404001 : Geçersiz endpoint
401002: AccessKey, AccessSecret parametreleri hatalı.
400008: subscriberId parametresi hatalı.
400009: Subscriber profili bulunamadı.
500000: Sunucu hatası.
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ı.
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