Konsep

Pembayaran dan lembar pembayaran

Salin halaman

Orang membayar untuk apa yang aplikasi Anda jual di $LIA, pada lembar pembayaran Lia, pada harga dalam catatan Lia. Server Anda memverifikasi setiap pembayaran, mengirimkannya, atau mengembalikan uangnya.

#Bagaimana pembayaran bekerja

Halaman Anda bertanyaLia.pay("extra-lives") dengan id dari salah satu produk Anda.
Lembar pembayaran Lia muncul di atas aplikasi AndaIni menampilkan item dan harganya dari catatan Lia (bukan dari halaman Anda), nama aplikasi Anda dan nama pengembang, serta saldo orang tersebut setelahnya.
Orang tersebut mengonfirmasiThe $LIA meninggalkan saldo mereka. Lia Labs menyimpan bagian Anda untuk Anda, dan biaya dicatat untuk aplikasi Anda sebagai paid.
Halaman Anda mendengarnyapay() jawaban { chargeId, productId }. A charge.paid webhook juga dikirim ke server kamu.
Server Anda mengirimkanItu memeriksa biaya dengan Lia, memberikan orang apa yang mereka beli, dan menandai biaya tersebut delivered. Atau, jika tidak bisa, mengembalikan uangnya.

Halaman Anda tidak pernah menangani uang, kartu, atau dompet, dan dapat't mengubah harga: lembaran hanya pernah menunjukkan apa'di Lia'catatan.

#Produk

Apa yang aplikasi Anda jual diatur oleh tim Lia (sampai portal pengembang tiba). Setiap produk memiliki:

Bidang	Aturan
`id`	1 hingga 64 karakter: huruf, angka, `_`, `.` dan `-`, dimulai dengan huruf atau digit. Ini adalah apa yang Anda berikan ke `Lia.pay()`.
`name`	Maksimal 60 karakter, ditampilkan di lembar pembayaran dan di orang's aktivitas.
`price`	Di $LIA, lebih dari 0 dan maksimal 1,000,000, hingga 6 tempat desimal.
`active`	Menghapus produk hanya menyembunyikannya: tagihan sebelumnya tetap ada.

Server Anda dapat mendaftarkannya dengan GET /products.

#Biaya

Sebuah pembayaran. Memiliki id seperti ch_9b1f… dan sebuah status:

Status	Makna
`paid`	Orang tersebut membayar. Aplikasi Anda tidak'tidak mengirimkannya belum.
`delivered`	Server Anda mengatakan bahwa itu telah dikirimkan. Mengirim ulang tidak mengubah apa pun.
`refunded`	The $LIA kembali ke orang tersebut. Biaya yang dikembalikan dapat't akan dikirimkan.

Server Anda bekerja dengan biaya melalui GET /charges/:id, POST /charges/:id/deliver dan POST /charges/:id/refund.

Ketika pembayaran langsung dilakukan, harga penuh keluar dari orang tersebut'saldo mereka. Bagian Anda (70% kecuali disepakati lain dengan tim Lia) disimpan untuk Anda oleh Lia Labs, dan sisanya tetap dengan Lia. Refund memberi orang tersebut harga penuh kembali, dari keduanya.

Lia Labs membayarkan bagian Anda setiap bulan, ke dalam saldo Lia Anda sendiri. Dari mainnet $LIA di Q1 2028, Anda dapat menariknya ke dompet Anda sendiri. Lihat Mendapatkan pembayaran.

#Jangan pernah kehilangan pembayaran

Halaman dapat me-reload, crash, atau kehilangan koneksi antara lembar pembayaran dan server Anda. Lia menyimpan setiap pembayaran hingga server Anda mengirimkannya, dan memberi halaman tiga cara untuk menemukannya:

pay() jawaban dengan { chargeId, productId } dalam kasus normal.
Lia.onCharge(fn) mendengar pembayaran yang dikonfirmasi saat tidak ada pay() sedang menunggu, misalnya setelah halaman direload sementara lembaran masih terbuka.
Lia.charges() mencantumkan pemain ini'tagihan yang dibayar, tidak terkirim (terlama terlebih dahulu, hingga 50). Panggil saat aplikasi Anda dibuka.

Dan server Anda bisa mengandalkan charge.paid webhook bukan di halaman. Jual item menggabungkan semuanya.

#Ketika pembayaran tidak'tidak terjadi

Lia.pay() gagal dengan kesalahan yang code katakan mengapa:

Kode	Kapan
`cancelled`	Orang tersebut menutup lembar tanpa membayar. Yang paling umum: anggap sebagai normal "tidak".
`no_product`	Di sini'tidak ada produk aktif dengan id itu untuk aplikasi Anda.
`busy`	Yang lain dari Lia'layar sudah terbuka di atas aplikasi Anda.
`bad_productId`	ID tidak'kirim teks hingga 64 karakter.

Jika orang itu tidak'tidak memiliki cukup $LIA, atau pembayaran gagal di tengah jalan, lembar pembayaran memberi tahu mereka sendiri dan tetap terbuka sehingga mereka dapat mencoba lagi. Halaman Anda hanya mendengar cancelled ketika mereka menutupnya.

#Mode uji

Dalam mode uji coba, lembar pembayaran menunjukkannya, tidak ada yang'saldo mereka berpindah, dan tidak ada yang perlu cukup $LIA. Semua yang lain (server Anda'panggilan, webhooks, pengiriman, dan pengembalian dana) bekerja seperti di mode live. Lihat Uji dan live.

#Lembar pembayaran di Lia

Tangkapan layar di bawah ini adalah penangkapan penuh dari Lia pada Android, menunjukkan konfirmasi pembayaran untuk Lia Chess. Halaman Anda meminta pembayaran; orang tersebut mengonfirmasi di lembaran sendiri Lia.

Konfirmasi pembayaran Lia pada Android

Diterjemahkan otomatis. Bahasa Inggris adalah sumber kebenaran. Baca dalam Bahasa Inggris