Thực hiện mua hàng trong ứng dụng di động với Flutter SDK

Hiển thị paywall trong ứng dụng di động là bước quan trọng để cung cấp cho người dùng quyền truy cập vào nội dung hoặc dịch vụ cao cấp. Tuy nhiên, việc hiển thị paywall chỉ tự hỗ trợ mua hàng khi Adapty render màn hình đó — tức là một flow, hoặc paywall từ Paywall Builder cũ.

Nếu bạn tự render màn hình trong code của mình, bạn phải sử dụng một phương thức riêng gọi là .makePurchase() để hoàn tất giao dịch mua và mở khóa nội dung mong muốn. Phương thức này là cổng để người dùng tương tác với các paywall và tiến hành giao dịch theo ý muốn.

Nếu paywall của bạn có ưu đãi đang hoạt động cho sản phẩm mà người dùng đang cố mua, Adapty sẽ tự động áp dụng ưu đãi đó tại thời điểm mua hàng.

Hãy đảm bảo bạn đã thực hiện cấu hình ban đầu mà không bỏ qua bất kỳ bước nào. Nếu không, chúng tôi không thể xác thực các giao dịch mua.

Thực hiện mua hàng

try {
  final purchaseResult = await Adapty().makePurchase(product: product);
    switch (purchaseResult) {
      case AdaptyPurchaseResultSuccess(profile: final profile):
        if (profile.accessLevels['premium']?.isActive ?? false) {
          // Grant access to the paid features
        }
        break;
      case AdaptyPurchaseResultPending():
        break;
      case AdaptyPurchaseResultUserCancelled():
        break;
      default:
        break;
    }
} on AdaptyError catch (adaptyError) {
    // Handle the error
} catch (e) {
    // Handle the error
}

Tham số yêu cầu:

Tham số phản hồi:

Thay đổi gói đăng ký khi mua hàng

Khi người dùng chọn một gói đăng ký mới thay vì gia hạn gói hiện tại, cách thức hoạt động sẽ phụ thuộc vào cửa hàng:

• Với App Store, gói đăng ký sẽ tự động được cập nhật trong nhóm gói đăng ký. Nếu người dùng mua một gói đăng ký từ nhóm này trong khi đã có gói đăng ký từ nhóm khác, cả hai gói sẽ cùng hoạt động đồng thời.
• Với Google Play, gói đăng ký không tự động được cập nhật. Bạn cần xử lý việc chuyển đổi trong code của ứng dụng như mô tả bên dưới.

Để thay thế gói đăng ký bằng một gói khác trên Android, hãy gọi phương thức .makePurchase() với tham số bổ sung:

try {
  final subscriptionUpdateParams = AdaptyAndroidSubscriptionUpdateParameters(
    'OLD_PRODUCT_ID',
    AdaptyAndroidSubscriptionUpdateReplacementMode.immediateWithTimeProration,
  );

  final result = await Adapty().makePurchase(
    product: product,
    parameters: AdaptyPurchaseParameters(
      subscriptionUpdateParams: subscriptionUpdateParams,
    ),
  );
  
  // successful cross-grade
} on AdaptyError catch (adaptyError) {
  // Handle the error
} catch (e) {
  // Handle the error
}

Tham số yêu cầu bổ sung:

Bạn có thể đọc thêm về gói đăng ký và các chế độ thay thế trong tài liệu dành cho nhà phát triển của Google:

• Về các chế độ thay thế
• Đề xuất từ Google về các chế độ thay thế
• Chế độ thay thế CHARGE_PRORATED_PRICE. Lưu ý: phương thức này chỉ áp dụng cho việc nâng cấp gói đăng ký. Hạ cấp không được hỗ trợ.
• Chế độ thay thế DEFERRED. Lưu ý: Việc thay đổi gói đăng ký thực sự chỉ xảy ra khi chu kỳ thanh toán hiện tại kết thúc.

Đổi mã ưu đãi trong iOS

Để hiển thị màn hình nhập mã trong ứng dụng của bạn:

try {
  await Adapty().presentCodeRedemptionSheet();
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
  // handle the error
}

Sản phẩm mua trong ứng dụng được quảng bá từ App Store

Khi người dùng bắt đầu mua hàng từ trang sản phẩm App Store của bạn và giao dịch được chuyển vào ứng dụng, SDK sẽ gửi sản phẩm đến didReceivePromotedPurchaseStream. Hãy đăng ký stream và truyền sản phẩm vào makePromotedPurchase:

Adapty().didReceivePromotedPurchaseStream.listen((product) async {
  try {
    final result = await Adapty().makePromotedPurchase(product: product);
    // process the purchase result
  } on AdaptyError catch (adaptyError) {
    // handle the error
  } catch (e) {
    // handle the error
  }
});

Đăng ký ngay sau activate khi khởi động ứng dụng, để listener tồn tại trước khi có promoted purchase đến. didReceivePromotedPurchaseStream là broadcast stream không replay: nếu có sản phẩm được gửi đến trong khi không có listener nào đang lắng nghe, sản phẩm đó sẽ bị mất.

makePromotedPurchase không nhận tham số mua hàng, vì sản phẩm được promoted đến từ App Store chứ không phải từ paywall và không mang theo context của paywall. Hàm này trả về cùng kiểu AdaptyPurchaseResult như makePurchase.

Nếu sản phẩm được quảng bá có kèm ưu đãi gói đăng ký, SDK sẽ tự động áp dụng ưu đãi đó khi mua. Ưu đãi được đọc từ purchase intent của App Store, vốn chỉ khả dụng trên iOS 18.0 trở lên. Trên iOS 16.4–17.x, giao dịch mua sẽ được thực hiện với giá gốc.

Quản lý prepaid plans (Android)

Nếu người dùng ứng dụng của bạn có thể mua prepaid plans (ví dụ: mua gói đăng ký không tự gia hạn trong vài tháng), bạn có thể bật pending transactions cho prepaid plans.

await Adapty().activate(
  configuration: AdaptyConfiguration(apiKey: 'YOUR_PUBLIC_SDK_KEY')
    ..withGoogleEnablePendingPrepaidPlans(true),
);