ÿÿ Chấp nhận thanh toán web cho ứng dụng Kotlin Multiplatform | Tài liệu Adapty

Triển khai web paywall trong Kotlin Multiplatform SDK

Trước khi bắt đầu, hãy đảm bảo bạn đã cấu hình web paywall trong dashboard và cài đặt Adapty SDK phiên bản 3.15 trở lên.

Mở web paywall

Nếu bạn đang làm việc với paywall do chính bạn phát triển, bạn cần xử lý web paywall bằng phương thức SDK. Phương thức openWebPaywall:

  1. Tạo má»™t URL duy nhất giúp Adapty liên kết paywall cụ thể được hiển thị cho ngưá»i dùng vá»›i trang web mà hỠđược chuyển hướng đến.
  2. Theo dõi khi ngưá»i dùng quay lại ứng dụng, sau đó gá»i getProfile theo chu kỳ ngắn để xác định xem quyá»n truy cập cá»§a hồ sÆ¡ ngưá»i dùng có được cập nhật hay không.

NhỠđó, nếu thanh toán thành công và quyá»n truy cập được cập nhật, gói đăng ký sẽ kích hoạt trong ứng dụng gần như ngay lập tức.

Sau khi ngưá»i dùng quay lại ứng dụng, hãy làm má»›i giao diện để phản ánh các cập nhật hồ sÆ¡ ngưá»i dùng. Adapty sẽ nhận và xá»­ lý các sá»± kiện cập nhật hồ sÆ¡ ngưá»i dùng.


viewModelScope.launch {
    Adapty.openWebPaywall(product = product).onSuccess {
        // the web paywall was opened successfully
    }.onError { error ->
        // handle the error
    }
}

Có hai phiên bản của phương thức openWebPaywall:

  1. openWebPaywall(product = product) tạo URL theo paywall và thêm dữ liệu sản phẩm vào URL.
  2. openWebPaywall(paywall = paywall) tạo URL theo paywall mà không thêm dữ liệu sản phẩm vào URL. Dùng khi các sản phẩm trong Adapty paywall của bạn khác với các sản phẩm trong web paywall.

Trong SDK v4, tham số paywall được thay thế bằng tham số flowPaywall nhận một AdaptyFlowPaywall — một trong các biến thể paywall trong flow.paywalls. Xem hướng dẫn migration.

Mở web paywall trong trình duyệt trong ứng dụng

Theo mặc định, web paywall sẽ mở trong trình duyệt bên ngoài.

Äể mang lại trải nghiệm liá»n mạch cho ngưá»i dùng, bạn có thể mở web paywall trong trình duyệt tích hợp ngay trong ứng dụng. Cách này hiển thị trang mua hàng trá»±c tiếp bên trong ứng dụng cá»§a bạn, giúp ngưá»i dùng hoàn tất giao dịch mà không cần chuyển sang ứng dụng khác.

Äể bật tính năng này, đặt tham số openIn thành AdaptyWebPresentation.IN_APP_BROWSER:


viewModelScope.launch {
    Adapty.openWebPaywall(
        product = product,
        openIn = AdaptyWebPresentation.IN_APP_BROWSER // default – EXTERNAL_BROWSER
    ).onSuccess {
        // the web paywall was opened successfully
    }.onError { error ->
        // handle the error
    }
}
ÿÿÿÿ