Понятия
Платежи и список выплат
Копировать страницу
Люди платят за то, что ваше приложение продает в $LIA, на собственном листе Lia, по цене в записях Lia. Ваш сервер подтверждает каждый платеж, доставляет его или возвращает.
#Как работает платеж
- Ваша страница спрашивает
Lia.pay("extra-lives")с id одного из ваших продуктов. - Lia платежная ведомость открывается поверх вашего приложенияОно показывает предмет и его цену из записей Lia (никогда не с вашей страницы), ваше приложение и имя разработчика, а также баланс человека после.
- Человек подтверждаетThe $LIA покидает свой баланс. Lia Labs хранит вашу долю за вас, и списание записывается для вашего приложения как
paid. - Ваша страница слышит это
pay()ответы{ chargeId, productId }. Acharge.paidвебхук отправляется на ваш сервер тоже. - Ваш сервер доставляетОн проверяет платеж с помощью Lia, дает человеку то, что он купил, и отмечает платеж
delivered. Или, если не может, возвращает деньги.
Ваша страница никогда не обрабатывает деньги, карты или кошельки, и может't изменить цену: таблица показывает только то, что'в Lia'ваша запись.
#Продукты
Что ваше приложение продает, настраивается командой Lia (до появления портала разработчика). Каждый продукт имеет:
| Поле | Правила |
|---|---|
id | 1 до 64 символов: буквы, цифры, _, . и -, начинается с буквы или цифры. Это то, что вы передаете Lia.pay(). |
name | До 60 символов, отображается на платежном листе и в личном's активность. |
price | В $LIA, больше 0 и до 1,000,000, до 6 десятичных знаков. |
active | Удаление продукта скрывает его: его предыдущие платежи остаются. |
Ваш сервер может перечислить их с помощью GET /products.
#Начисления
Платеж — это один платеж. У него есть id, например ch_9b1f… и статус:
| Статус | Значение |
|---|---|
paid | Человек оплатил. Ваше приложение не'не доставлено еще. |
delivered | Ваш сервер сказал, что доставил это. Доставка повторно ничего не изменит. |
refunded | The $LIA вернулся к человеку. Возвращённая оплата может't быть доставлено. |
Ваш сервер работает с платежами через GET /charges/:id, POST /charges/:id/deliver и POST /charges/:id/refund.
#Ваша доля
Когда оплата за живой платеж произведена, полная цена покидает человека'баланс. Ваша доля (70% , если не согласовано иначе с командой Lia) хранится для вас Lia Labs, а остальное остается у Lia. Возврат возвращает человеку полную цену, из обеих.
Lia Labs ежемесячно выплачивает вашу долю в вашем собственном Lia балансе. С $LIA основной сети в Q1 2028, вы можете вывести его в свою собственную кошельку. См. Получение оплаты.
#Никогда не теряйте платеж
Страница может перезагрузиться, зависнуть или потерять соединение между платежной формой и вашим сервером. Lia сохраняет каждый оплаченный платеж до тех пор, пока ваш сервер не доставит его, и предоставляет вашей странице три способа их найти:
pay()ответы с{ chargeId, productId }в обычном случае.Lia.onCharge(fn)слышит начисление, которое было подтверждено, когда неpay()ожидал, например, после перезагрузки страницы, когда лист был открыт.Lia.charges()список этого игрока'оплаченные, не доставленные платежи (самые старые первыми, до 50). Вызывайте его, когда ваше приложение открывается.
И ваш сервер может полагаться на charge.paid вебхук вместо страницы. Продать предмет объединяет все это.
#Когда платеж не произошел'не произойдет
Lia.pay() неудача с ошибкой, чей code говорит, почему:
| Код | Когда |
|---|---|
cancelled | Человек закрыл лист без оплаты. Самая распространенная причина: рассматривайте это как обычное "нет". |
no_product | Там'нет активного продукта с этим идентификатором для вашего приложения. |
busy | Еще один из Lia'ваш экраны уже открыт над вашим приложением. |
bad_productId | Идентификатор не'не текст до 64 символов. |
Если человек не'не иметь достаточно $LIA, или платеж не проходит по пути, лист оплаты сообщает им само и остается открытым, чтобы они могли попробовать снова. Ваша страница слышит только cancelled когда они закрывают его.
#Режим тестирования
В режиме тестирования оплата указана на листе, никто'баланс перемещается, и никто не нуждается в достаточном $LIA. Все остальное (ваш сервер'вызовы, вебхуки, доставка и возврат) работают как в режиме реального времени. См. Тест и живой.
#Ведомость оплаты в Lia
Снимок экрана ниже — полное захват из Lia на Android, показывающий подтверждение оплаты для Lia Шахмат. Ваша страница запрашивает оплату; человек подтверждает в собственной таблице Lia.
Автоматически переведено. Английский — источник истины. Читать на английском