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

Hiển thị paywall trong ứng dụng di động là bước thiết yếu để 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, chỉ khi Adapty tự render màn hình — tức là một flow, hoặc paywall từ Paywall Builder cũ — thì việc hiển thị paywall mới tự hỗ trợ mua hàng mà không cần thêm gì.

Nếu bạn tự render màn hình trong code của mình, bạn cần sử dụng một phương thức riêng gọi là .makePurchase() để hoàn tất giao dịch 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à thực hiện giao dịch của họ.

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 sẽ không thể xác thực các giao dịch mua.

Thực hiện mua hàng

try {
  const result = await adapty.makePurchase({ product });
  
  if (result.type === 'success') {
    const isSubscribed = result.profile?.accessLevels?.['YOUR_ACCESS_LEVEL']?.isActive;
    
    if (isSubscribed) {
      // Grant access to the paid features
      console.log('User is now subscribed!');
    }
  } else if (result.type === 'user_cancelled') {
    console.log('Purchase cancelled by user');
  } else if (result.type === 'pending') {
    console.log('Purchase is pending');
  }
} catch (error) {
  console.error('Purchase failed:', error);
}

Tham số phản hồi:

Thay đổi gói đăng ký khi thực hiện 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 hoạt động sẽ khác nhau tùy theo cửa hàng:

• Đối với App Store, gói đăng ký được tự động 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ẽ hoạt động cùng lúc.
• Đối với Google Play, gói đăng ký không được tự động cập nhật. Bạn cần xử lý việc chuyển đổi trong code ứng dụng của mình 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 {
  const result = await adapty.makePurchase({ 
    product,
    params: {
      android: {
        subscriptionUpdateParams: {
          oldSubVendorProductId: 'old_product_id',
          prorationMode: 'charge_prorated_price'
        },
        isOfferPersonalized: true
      }
    }
  });
  
  if (result.type === 'success') {
    const isSubscribed = result.profile?.accessLevels?.['YOUR_ACCESS_LEVEL']?.isActive;
    
    if (isSubscribed) {
      // Grant access to the paid features
      console.log('Subscription updated successfully!');
    }
  } else if (result.type === 'user_cancelled') {
    console.log('Purchase cancelled by user');
  } else if (result.type === 'pending') {
    console.log('Purchase is pending');
  }
} catch (error) {
  console.error('Purchase failed:', error);
}

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

Cấu trúc MakePurchaseParamsInput bao gồm:

{
  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ị từ Google về các chế độ thay thế
• Chế độ thay thế CHARGE_PRORATED_PRICE. Lưu ý: phương thức này chỉ khả dụng khi 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ỉ diễn ra khi chu kỳ thanh toán hiện tại kết thúc.

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.

await adapty.activate({
  apiKey: 'YOUR_PUBLIC_SDK_KEY',
  params: {
    android: {
        pendingPrepaidPlansEnabled: true,
    },
  }
});

Đổi mã ưu đãi trên iOS

Để hiển thị giao diện nhập mã trong ứng dụng của bạn:

try {
  await adapty.presentCodeRedemptionSheet();
} catch (error) {
  console.error('Failed to present code redemption sheet:', error);
}

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 thị ngay lập tức và Adapty xử lý giao dịch như bất kỳ sản phẩm mua hàng nào khác. Bạn không cần viết thêm bất kỳ đoạn code nào.

Nếu sản phẩm được quảng bá kèm theo ưu đãi gói đăng ký, SDK sẽ tự động áp dụng ưu đãi đó khi mua hàng. Ưu đãi được đọc từ purchase intent của App Store, tính năng này 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 theo giá gốc.

Để tự xử lý việc hoàn tất giao dịch — ví dụ như hiển thị màn hình của bạn trước — hãy lắng nghe sự kiện 'onPromotedPurchaseReceived' và truyền sản phẩm vào makePromotedPurchase:

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

makePromotedPurchase không nhận tham số mua — một promoted product đến từ App Store chứ không phải từ paywall, nên nó không mang theo ngữ cảnh paywall. Hàm này trả về cùng AdaptyPurchaseResult như makePurchase.

Việc gọi adapty.removeAllListeners() sẽ xóa cả listener xử lý promoted-purchase cùng với các listener còn lại, và SDK sẽ tự động tiếp quản việc hoàn tất giao dịch. Hãy đăng ký lại listener nếu ứng dụng của bạn vẫn cần tự xử lý việc hoàn tất.