Khái niệm
Thanh toán và bảng thanh toán
Sao chép trang
Mọi người thanh toán cho những gì ứng dụng của bạn bán trong $LIA, trên bảng thanh toán riêng của Lia, với giá trong hồ sơ của Lia. Máy chủ của bạn xác nhận mỗi lần thanh toán, giao hàng hoặc hoàn tiền.
#Cách một khoản thanh toán hoạt động
- Trang của bạn hỏi
Lia.pay("extra-lives")với id của một trong các sản phẩm của bạn. - Bảng thanh toán của Lia mở lên trên ứng dụng của bạnNó hiển thị mục và giá của nó từ hồ sơ Lia (không phải trang của bạn), tên ứng dụng và tên nhà phát triển của bạn, và số dư của người đó sau đó.
- Người xác nhậnCái $LIA rời khỏi số dư của họ. Lia Labs giữ phần chia sẻ của bạn cho bạn, và phí được ghi lại cho ứng dụng của bạn như
paid. - Trang của bạn nghe nó
pay()câu trả lời{ chargeId, productId }. Acharge.paidwebhook cũng gửi đến máy chủ của bạn. - Máy chủ của bạn phân phốiNó kiểm tra khoản phí với Lia, cung cấp cho người đó những gì họ đã mua, và ghi lại khoản phí
delivered. Hoặc, nếu không thể, hoàn tiền.
Trang của bạn không bao giờ xử lý tiền, thẻ hoặc ví, và có thể't thay đổi giá: bảng chỉ bao giờ hiển thị điều'trong Lia'các bản ghi.
#Sản phẩm
Loại sản phẩm mà ứng dụng của bạn bán được thiết lập bởi đội ngũ Lia (cho đến khi cổng phát triển ra mắt). Mỗi sản phẩm có:
| Trường | Quy tắc |
|---|---|
id | 1 đến 64 ký tự: chữ cái, chữ số, _, . và -, bắt đầu bằng chữ cái hoặc chữ số. Đây là điều bạn truyền cho Lia.pay(). |
name | Tối đa 60 ký tự, hiển thị trên bảng thanh toán và trong người's khung quảng cáo tải trong trang của bạn, và một lần chạm vào quảng cáo mở Safari. Số tiền đó sẽ đi vào tài khoản Google của bạn. Xem |
price | Trong $LIA, lớn hơn 0 và tối đa 1,000,000, đến 6 chữ số thập phân. |
active | Việc xóa một sản phẩm chỉ ẩn nó đi: các khoản phí trước đây vẫn tồn tại. |
Máy chủ của bạn có thể liệt kê chúng với GET /products.
#Phí
Một khoản thanh toán. Nó có một id như ch_9b1f… và một trạng thái:
| Trạng thái | Ý nghĩa |
|---|---|
paid | Người đã thanh toán. Ứng dụng của bạn không phải'chưa giao nó yet. |
delivered | Máy chủ của bạn đã nói rằng nó đã phân phối. Phân phối lại không thay đổi gì. |
refunded | Cái $LIA đã quay lại người đó. Một khoản hoàn tiền có thể't được giao. |
Máy chủ của bạn làm việc với các khoản phí thông qua GET /charges/:id, POST /charges/:id/deliver và POST /charges/:id/refund.
#Lợi nhuận của bạn
Khi một khoản thanh toán trực tiếp được thanh toán, toàn bộ giá trị sẽ rời khỏi người đó'số dư của bạn. Phần của bạn (70% trừ khi bạn thỏa thuận khác với đội Lia) được giữ bởi Lia Labs, và phần còn lại ở lại với Lia. Một khoản hoàn tiền trả lại cho người đó toàn bộ giá trị, từ cả hai.
Lia Labs trả phần chia sẻ của bạn hàng tháng, vào số dư Lia của bạn. Từ mainnet $LIA trong Q1 2028, bạn có thể rút nó về ví của riêng bạn. Xem Nhận thanh toán.
#Đừng bao giờ để mất một khoản thanh toán
Một trang có thể tải lại, treo hoặc mất kết nối giữa bảng thanh toán và máy chủ của bạn. Lia giữ lại mọi giao dịch thanh toán cho đến khi máy chủ của bạn nhận được nó, và cung cấp cho trang của bạn ba cách để tìm chúng:
pay()câu trả lời với{ chargeId, productId }trong trường hợp bình thường.Lia.onCharge(fn)nghe một khoản phí đã được xác nhận trong khi khôngpay()đang chờ, ví dụ sau khi trang được tải lại trong khi bảng tính vẫn mở.Lia.charges()liệt kê người chơi này'các khoản phí đã thanh toán, chưa được giao (cũ nhất trước, tối đa 50). Gọi nó khi ứng dụng của bạn mở.
Và máy chủ của bạn có thể dựa vào charge.paid webhook thay vì trang. Bán một vật phẩm kết hợp tất cả những điều này lại với nhau.
#Khi một khoản thanh toán không'xảy ra
Lia.pay() thất bại với một lỗi có code nói lý do:
| Mã | Khi nào |
|---|---|
cancelled | Người đã đóng bảng mà không thanh toán. Một trường hợp phổ biến nhất: coi đó là một trường hợp bình thường "không". |
no_product | Có'không có sản phẩm nào đang hoạt động với id đó cho ứng dụng của bạn. |
busy | Một trong những Lia'các màn hình đã mở trên ứng dụng của bạn. |
bad_productId | Id không phải'ký tự tối đa 64. |
Nếu người đó không'có đủ $LIA, hoặc thanh toán thất bại trên đường, bảng thanh toán sẽ tự thông báo và vẫn mở để họ có thể thử lại. Trang của bạn chỉ nghe thấy cancelled khi họ đóng nó.
#Chế độ kiểm tra
Trong chế độ thử nghiệm, bảng thanh toán sẽ nói rõ, không ai'số dư di chuyển, và không ai cần đủ $LIA. Mọi thứ khác (máy chủ của bạn'các cuộc gọi, webhook, giao hàng và hoàn tiền) hoạt động như trong chế độ trực tiếp. Xem Kiểm tra và trực tiếp.
#Bảng thanh toán trong Lia
Hình ảnh dưới đây là một bản chụp toàn bộ từ Lia vào ngày Android, cho thấy xác nhận thanh toán cho Lia Chess. Trang của bạn yêu cầu thanh toán; người dùng xác nhận trong bảng riêng của Lia.
Được dịch tự động. Tiếng Anh là nguồn tin cậy. Đọc bằng tiếng Anh