Thực hiện mua hàng trong ứng dụng với React Native 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ự động 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 đóng vai trò là cổng để người dùng tương tác với các paywall và tiến hành các giao dịch họ 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 muốn mua, Adapty sẽ tự động áp dụng ưu đãi đó tại thời điểm thanh toán.

Hãy đảm bảo bạn đã hoàn thành 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 giao dịch mua hàng.

Thực hiện mua hàng

try {
    const purchaseResult = await adapty.makePurchase(product);
    switch (purchaseResult.type) {
      case 'success':
        const isSubscribed = purchaseResult.profile?.accessLevels['YOUR_ACCESS_LEVEL']?.isActive;

        if (isSubscribed) {
          // Grant access to the paid features
        }
        break;
      case 'user_cancelled':
        // Handle the case where the user canceled the purchase
        break;
      case 'pending':
        // Handle deferred purchases (e.g., the user will pay offline with cash)
        break;
    }
} catch (error) {
    // 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 xử lý 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 cùng nhóm gói đăng ký. Nếu người dùng mua một gói từ nhóm này trong khi đã có gói từ nhóm khác, cả hai gói đều sẽ 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 ứng dụng như mô tả bên dưới.

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

try {
    const purchaseResult = await adapty.makePurchase(product, params);
    switch (purchaseResult.type) {
      case 'success':
        const isSubscribed = purchaseResult.profile?.accessLevels['YOUR_ACCESS_LEVEL']?.isActive;

        if (isSubscribed) {
          // Grant access to the paid features
        }
        break;
      case 'user_cancelled':
        // Handle the case where the user canceled the purchase
        break;
      case 'pending':
        // Handle deferred purchases (e.g., the user will pay offline with cash)
        break;
    }
} catch (error) {
    // Handle the error
}

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

makePurchase(product, {
    android: {
        subscriptionUpdateParams: {
            oldSubVendorProductId: 'old_product_id',
            prorationMode: 'charge_prorated_price'
        },
        isOfferPersonalized: true
    }
});

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

• Về các chế độ thay thế
• Khuyến nghị của Google về 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 trên iOS

Để hiển thị sheet đổi mã trong ứng dụng:

adapty.presentCodeRedemptionSheet();

Sản phẩm đượ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 sang ứng dụng, SDK sẽ tự động hoàn tất giao dịch đó — màn hình mua hàng của Apple hiện ra ngay lập tức, và Adapty xử lý giao dịch như bất kỳ sản phẩm mua nào khác. Bạn không cần viết thêm code cho việc này.

Nếu sản phẩm được quảng bá kèm theo ưu đãi của 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, chỉ hiển thị 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 theo giá gốc.

Nếu bạn muốn tự xử lý việc hoàn tất mua hàng — chẳng hạn để hiển thị màn hình của riêng bạn trước — hãy lắng nghe sự kiện 'onPromotedPurchaseReceived' và truyền sản phẩm vào makePromotedPurchase:

adapty.addEventListener('onPromotedPurchaseReceived', async product => {
  const result = await adapty.makePromotedPurchase(product);
  // process the purchase result
});

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

Các listener có tính cộng dồn: nếu bạn đăng ký nhiều listener, mỗi listener đều nhận được sản phẩm, và không có listener nào hoàn tất việc mua hàng thay cho các listener còn lại.

Quản lý gói trả trước (Android)

Nếu người dùng ứng dụng của bạn có thể mua gói trả trước (ví dụ: mua gói đăng ký không tự gia hạn cho vài tháng), bạn có thể bật giao dịch đang chờ xử lý cho các gói trả trước.

adapty.activate("PUBLIC_SDK_KEY", {
    android: { pendingPrepaidPlansEnabled: true }
});