Konsepto

Payments and the pay sheet

Kopya ang pahina

Ang mga tao ay nagbabayad para sa kung ano ang iyong app ibinebenta sa $LIA, sa Lia's own pay sheet, sa presyo sa mga talaan ng Lia. Ang iyong server ay kumpirmahin ang bawat charge, ipadala ito, o refund ito.

#Paano gumagana ang isang pagbabayad

Ang iyong pahina ay nagsusumamoLia.pay("extra-lives") kasama ang id ng isang produkto mula sa iyong mga produkto.
Ang pay sheet ng Lia ay nagsisimula sa ibabaw ng iyong appNagpapakita ng item at ang kanyang presyo mula sa mga talaan ng Lia (hindi ang iyong pahina), ang pangalan ng iyong app at developer, at ang balanse ng tao pagkatapos.
Ang tao ay kumpirmaAng $LIA ay umalis na may kanilang balanse. Lia Labs ay nangangalaga ng iyong bahagi para sa iyo, at ang gastos ay nakarehistro para sa iyong app bilang paid.
Ang iyong pahina ay nakikinig nitopay() mga sagot { chargeId, productId }. A charge.paid ang webhook ay pumunta sa iyong server din.
Ang iyong server ay nagdalaIto ay sinuri ang charge sa Lia, ibinibigay sa tao ang kanyang binili, at itinala ang charge delivered. O, kung hindi, ibabalik ito.

Ang iyong pahina ay walang nakikitungo sa pera, mga kard o mga wallet, at maaaring't baguhin ang presyo: ang sheet ay palaging nagpapakita kung ano's sa Lia's records.

#Mga Produkto

Ano ang inaabot ng iyong app ay naka-configure ng Lia team (hanggang ang developer portal ay dumating). Ang bawat produkto ay mayroon:

Kampo	Mga Patakaran
`id`	1 hanggang 64 karakter: mga letra, digit, `_`, `.` at `-`, nagsisimula sa isang letra o digit. Ito ang nangangahulugan na ipapasa mo sa `Lia.pay()`.
`name`	Hanggang sa 60 mga karakter, ipinapakita sa pay sheet at sa tao's activity.
`price`	Sa $LIA, higit sa 0 at hanggang 1,000,000, para sa 6 decimal places.
`active`	Ang pagtanggal ng isang produkto ay nag-iiba ito lamang: ang mga nakaraang gastos ay nananatili.

Ang iyong server ay maaaring i-lista sila gamit ang GET /products.

#Mga singil

Isang charge ay isang pagbabayad. Mayroon itong id tulad ng ch_9b1f… at isang status:

Katayuan	Kahulugan
`paid`	Ang tao ay nagbayad. Ang iyong app ay hindi'hindi pa ipinadala ito.
`delivered`	Ang iyong server ay sinabi na nagdala ito. Ang pagdala muli ay walang pagbabago.
`refunded`	Ang $LIA ay bumalik sa tao. Ang isang refund na gastos ay maaaring't maibigay.

Ang iyong server ay gumagana sa mga bayarin sa pamamagitan ng GET /charges/:id, POST /charges/:id/deliver at POST /charges/:id/refund.

Kapag isang live charge ay binayaran, ang buong presyo ay umalis sa tao'na balance. Ang iyong bahagi (70% maliban kung ipinagkasundo nang iba kasama ang Lia team) ay naiimbak para sa iyo ng Lia Labs, at ang natitira ay nananatili sa Lia. Ang isang refund ay ibabalik sa tao ang buong presyo, mula sa pareho.

Lia Labs ay nagpapabayad ng iyong bahagi bawat buwan, sa iyong sariling Lia balance. Mula sa $LIA mainnet sa Q1 2028, maaari mo itong i-withdraw sa iyong sariling wallet. Tingnan Kumita.

#Huwag mawala ang pagbabayad

Ang isang pahina ay maaaring mag-reload, crash o mawala ang kanyang koneksyon sa pay sheet at sa iyong server. Lia ay nananatili sa bawat bayad hanggang ang iyong server ay magbigay nito, at nagbibigay sa iyong pahina ng tatlong paraan upang matagpuan ang mga ito:

pay() mga sagot kasama { chargeId, productId } sa normal na kaso.
Lia.onCharge(fn) narinig ang isang charge na kinumpirma habang walang pay() ay naghihintay, halimbawa pagkatapos ng pag reload habang ang sheet ay bukas.
Lia.charges() naglista ng kahit ano ang manlalaro's mga bayad na nagkakahalaga, hindi nakadala (pinaka-bata muna, hanggang 50). Tawagan ito kapag ang iyong app ay buksan.

At ang iyong server ay maaaring umasa sa charge.paid webhook sa halipang ang pahina. Bilhin ang isang item nag-uugnay ng lahat ng mga ito.

#Kapag ang pagbabayad ay hindi'hindi mangyari

Lia.pay() nabigo sa isang error na ang code sabi kung bakit:

Code	Kailan
`cancelled`	Ang tao ay sarado ang sheet nang walang pagbabayad. Ang pinaka-karaniwang isa: ituring ito bilang normal "hindi".
`no_product`	Dito's wala pang aktibong produkto na may id para sa iyong app.
`busy`	Isa pang Lia's screens ay nasa bukas na nang higit pa sa iyong app.
`bad_productId`	Ang id ay hindi'hindi maaabot teksto hanggang 64 mga karakter.

Kung ang tao ay hindi'hindi sapat ang $LIA, o ang pagbabayad ay nabigo sa daan, ang pay sheet ay nagsasabi sa kanila mismo at nananatili ito bukas para sila ay maaaring subukan muli. Ang iyong pahina ay nakikinig lamang cancelled nang sila ay i-override ito.

#Mode ng pagsusulit

Sa mode ng pagsusulit ang pay sheet ay nagsasabi nito, walang sinumang'na balance moves, at walang kailangan ng sapat na $LIA. Lahat ng iba (ang iyong server'na mga tawag, webhooks, pagdala at pag-refund) gumagana tulad ng live. Tingnan Pagsusulit at live.

#Ang pay sheet sa Lia

Ang screenshot sa ibaba ay isang kumpletong pagkakasunod-sunod mula sa Lia noong Android, na nagpapakita ng pagkumpirma ng pagbabayad para sa Lia Chess. Ang iyong pahina ay humihiling na magbayad; ang tao ay kumpirmasyon sa sariling sheet ni Lia.

Lia confirmation ng pagbabayad sa Android

Awtomatikong isinalin. Ang English ay ang source of truth. Basahin sa Ingles