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

Hiển thị paywall trong ứng dụ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, chỉ hiển thị paywall là đủ để hỗ trợ mua hàng nếu bạn sử dụng Paywall Builder để tuỳ chỉnh paywall của mình.

Nếu bạn không dùng Paywall Builder, bạn cần sử dụng một phương thức riêng 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 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 đang muốn 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 đã hoàn tất cấu hình ban đầu mà không bỏ sót 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 hàng.

Thực hiện mua hàng

using AdaptySDK;

void MakePurchase(AdaptyPaywallProduct product) {
  Adapty.MakePurchase(product, (result, error) => {
    switch (result.Type) {
      case AdaptyPurchaseResultType.Pending:
        // handle pending purchase
        break;
      case AdaptyPurchaseResultType.UserCancelled:
        // handle purchase cancellation
        break;
      case AdaptyPurchaseResultType.Success:
        var profile = result.Profile;
        // handle successfull purchase
        break;
      default:
        break;
    }
  });
}

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 hoạt động phụ thuộc vào cửa hàng:

• Đối với App Store, gói đăng ký được tự động cập nhật trong cùng nhóm gói đăng ký. Nếu người dùng mua gói đăng ký từ một nhóm trong khi đã có gói đăng ký từ nhóm khác, cả hai gói sẽ được kích hoạt đồng thời.
• Đối với Google Play, gói đăng ký không được tự động cập nhật. Bạn cần quản 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 một gói khác trên Android, gọi phương thức .makePurchase() với tham số bổ sung:

// Create subscription update parameters
var subscriptionUpdateParams = new AdaptySubscriptionUpdateParameters(
    "old_product_id", // Product ID of the current subscription
    AdaptySubscriptionUpdateReplacementMode.WithTimeProration
);

Adapty.MakePurchase(product, subscriptionUpdateParams, (profile, error) => {
  if(error != null) {
      // Handle the error
      return;
  }

  // successful cross-grade
});

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 Google Developer:

• Về các chế độ thay thế
• Khuyến nghị của 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ý. Không hỗ trợ hạ cấp.
• 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ị trang đổi mã trong ứng dụng của bạn:

Adapty.PresentCodeRedemptionSheet((error) => {
  // handle the error
});

In-app purchase từ App Store

Khi người dùng khởi tạo một giao dịch mua từ trang sản phẩm App Store và giao dịch đó được chuyển sang ứng dụng của bạn, SDK sẽ tự động hoàn tất — màn hình thanh toán của Apple hiện ra ngay lập tức, và Adapty xử lý giao dịch đó như mọi in-app purchase thông thường.

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, 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.

Để xử lý các giao dịch mua được quảng bá trong code của bạn, IAdaptyEventListener cung cấp phương thức OnReceivePromotedPurchase(AdaptyPromotedProduct), kết hợp với Adapty.MakePromotedPurchase để hoàn tất giao dịch mua nhận được:

public void OnReceivePromotedPurchase(AdaptyPromotedProduct product) {
    Adapty.MakePromotedPurchase(product, (result, error) => {
        // process the purchase result
    });
}

SDK hiện chưa chuyển promoted purchase đến phương thức này — thay vào đó, SDK sẽ tự động hoàn tất chúng — vì vậy bạn chưa thể trì hoãn promoted purchase để hiển thị gì đó tùy chỉnh trước. Dù vậy, hãy triển khai phương thức này (bắt buộc theo interface); phần thân rỗng là một cách triển khai hợp lệ.

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.

using UnityEngine;
using AdaptySDK;

var builder = new AdaptyConfiguration.Builder("YOUR_API_KEY")
    .SetGoogleEnablePendingPrepaidPlans(true);

Adapty.Activate(builder.Build(), (error) => {
    if (error != null) {
        // handle the error
        return;
    }
});