LiaGeliştiriciler

Kavramlar

Kullanıcılar uygulamanızın sattığı şeyi $LIA'da Lia'ın kendi ödeme tablosunda, Lia'nin kayıtlarındaki fiyattan öder. Sunucunuz her ödeme doğrular, teslim eder veya iade eder.

#Bir ödeme nasıl çalışır

  1. Sayfanız sorarLia.pay("extra-lives") sizin ürünlerinizden birinin kimliği ile.
  2. Lia'nın ödeme sayfası uygulamanızın üzerine açılır Lia'ın kayıtlarından (asla sayfanızın değil) öğeyi ve fiyatını, uygulamanız ve geliştirici adınızı, kişinin bakiyesini gösterir.
  3. Kişi onaylarThe $LIA hesap bakiyelerini terk eder. Lia Labs hesabınızın payını saklar ve bu ücret, uygulamanız için kaydedilir paid.
  4. Sayfanız onu duyarpay() cevaplar { chargeId, productId }. A charge.paid webhook da sunucunuza gider.
  5. Sunucunuz teslim ederO Lia ile ücreti kontrol eder, kişiye ne aldığını verir ve ücreti işaretleme delivered. Veya, yapamazsa, iade eder.

Sayfanız para, kartlar veya cüzdanlarla ilgilenmez ve alabilir't bir fiyatı değiştirmek: tablo sadece ne olduğunu gösterir's içinde Lia'kayıtlar.

#Ürünler

Uygulamanızın sattığı şey Lia ekibi tarafından ayarlanır (geliştirici portalı gelene kadar). Her ürün şu içerir:

AlanKurallar
id1 ile 64 karakter: harfler, rakamlar, _, . ve -, bir harf veya rakamla başlamalıdır. Bu, size verdiğiniz şeydir Lia.pay().
nameMaksimum 60 karakter, ödeme sayfasında ve kişi içinde gösterilir's etkinlik.
price$LIA içinde, 0'den fazla ve 1,000,000,'ye kadar 6 ondalık basamağa kadar
activeBir ürünün kaldırılması sadece onu gizler: geçmiş ücretleri kalır.

Sunucunuz bunları listelemek için GET /products.

#Yüklemler

Bir ödeme, bir kimliği vardır gibi ch_9b1f… ve bir durum:

DurumAnlam
paidKişi ödedi. Uygulamanızın'henüz teslim edilmedi.
deliveredSunucunuz onu teslim ettiğini söyledi. Tekrar teslim etmek hiçbir şeyi değiştirmez.
refundedThe $LIA kişiye geri döner. İade edilen bir ücret't teslim edilecek.

Ücretler aracılığıyla çalışır GET /charges/:id, POST /charges/:id/deliver ve POST /charges/:id/refund.

#Ayrımınız

Canlı bir ücret ödendiğinde, tam fiyat kişiye gider'u bakiye. Sizin payınız (70% aksi anlaşmaya varsa Lia ekibiyle) sizin için Lia Labs tarafından saklanır, ve kalanı Lia'e kalır. Bir iade, kişinin tam fiyatını iki taraftan da geri verir.

Lia Labs, aylık olarak kendi Lia bakiyenize öder. $LIA mainnet'ten Q1 2028, 'te çıkarabilirsiniz. Bkz. Ödeme alın.

#Bir ödeme kaybetme

Ödeme sayfası ile sunucunuz arasında bir sayfa yeniden yüklenebilir, çökebilir veya bağlantısı kopabilir. Lia her ödenen ücreti, sunucunuzun onu teslim etmesini bekler ve sayfanızın bunları bulması için üç yolu vardır:

  • pay() cevaplar ile { chargeId, productId } normal durumda.
  • Lia.onCharge(fn) hiçbir şey açıkken onaylanan bir ücret duydu. pay() bekliyordu, örneğin sayfa yeniden yüklendiğinde, fakat tablo açıkken.
  • Lia.charges() bu oyuncuyu listeler'ödenmemiş ödemeler (en eski ilk, 50 kadar). Uygulamanız açıldığında çağırın.

Ve sunucunuz bunun üzerine güvenebilir charge.paid webhook sayfadan ziyade. Bir eşya sat bunları hepsini bir araya getirir.

#Bir ödeme yapılmadığında'olacak

Lia.pay() başarısız olur ve code nedenini:

KodZaman
cancelledKişi sayfayı ödemeden kapattı. En yaygın olanı: normal bir şekilde ele al "hayır".
no_productOrada'hayır aktif ürün bu kimlikle uygulamanız için.
busyLia'ın başka biri'ekranlar uygulamanızın üzerine zaten açıktır.
bad_productIdid değil'en fazla 64 karakter metin.

Kişi değilse'yeterli $LIA yoksa, veya ödeme yolda başarısız olursa, ödeme sayfası kendini ona bildirir ve tekrar denemek için açık kalır. Sadece sayfanız duyar cancelled kapatırlar.

#Test modu

Test modunda ödeme sayfası bunu söyler, kimse'u bakiye hareketleri, ve kimse $LIA yeterli olmaz. Diğer her şey (sunucunuz'u çağrılar, webhooks'lar, teslim ve iade etme) canlı gibi çalışır. Bkz. Test ve canlı.

#Lia'daki ödeme sayfası

Aşağıdaki ekran görüntüsü, Lia üzerinde Android'de alınan tam bir yakalama, Lia Şah mati için ödeme onayını gösterir. Sayfanız ödemeyi istiyor; kişi Lia'ün kendi sayfasında onaylıyor.

Lia Android üzerinde ödeme onayı

Otomatik çeviri. İngilizce, doğru kaynaktır. İngilizce olarak oku

Her sayfa, yöntem ve uç noktayı aramak için yazın.