Quản lý giao dịch nâng cao trong iOS SDK

Quản lý giao dịch nâng cao trong Adapty cho phép bạn kiểm soát nhiều hơn cách các giao dịch được xử lý, xác minh và hoàn tất.

Tính năng này giới thiệu ba tính năng tùy chọn hoạt động cùng nhau:

Kết hợp lại, các công cụ này giúp bạn xây dựng quy trình xác thực tùy chỉnh mạnh mẽ trong khi Adapty vẫn tiếp tục đồng bộ giao dịch với backend của mình.

Gán appAccountToken

appAccountToken là một UUID cho phép bạn liên kết các giao dịch App Store với danh tính người dùng nội bộ của mình.
StoreKit gắn token này với mọi giao dịch, giúp backend của bạn có thể khớp dữ liệu App Store với người dùng của bạn.

Hãy sử dụng một UUID ổn định được tạo cho mỗi người dùng và tái sử dụng nó cho cùng một tài khoản trên các thiết bị. Điều này đảm bảo rằng các giao dịch mua và thông báo App Store được liên kết chính xác.

Bạn có thể đặt token theo hai cách – trong quá trình khởi tạo SDK hoặc khi xác định người dùng.

// During configuration:
let configurationBuilder =
    AdaptyConfiguration
        .builder(withAPIKey: "PUBLIC_SDK_KEY")
        .with(customerUserId: "YOUR_USER_ID", withAppAccountToken: UUID())

do {
  try await Adapty.activate(with: configurationBuilder.build())
} catch {
  // handle the error
}

// Or when identifying a user:
do {
    try await Adapty.identify("YOUR_USER_ID", withAppAccountToken: UUID())
} catch {
    // handle the error
}

// During configuration:
let configurationBuilder =
    AdaptyConfiguration
        .builder(withAPIKey: "PUBLIC_SDK_KEY")
        .with(customerUserId: "YOUR_USER_ID", withAppAccountToken: <APP_ACCOUNT_TOKEN>)

Adapty.activate(with: configurationBuilder.build()) { error in
  // handle the error
}

// Or when identifying a user:
Adapty.identify("YOUR_USER_ID", withAppAccountToken: <APP_ACCOUNT_TOKEN>) { error in
    if let error {
        // handle the error
    }
}

Truy cập biểu diễn JWS

Khi bạn thực hiện mua hàng, kết quả trả về bao gồm giao dịch của Apple ở định dạng JWS Compact Serialization. Bạn có thể chuyển giá trị này đến backend của mình để xác thực độc lập hoặc ghi log.

let result = try await Adapty.makePurchase(product: paywallProduct)
let jwsRepresentation = result.jwsTransaction

Kiểm soát hành vi hoàn tất giao dịch

Mặc định, Adapty tự động hoàn tất các giao dịch StoreKit sau khi xác thực. Nếu bạn cần trì hoãn việc hoàn tất cho đến khi backend xác nhận thành công, hãy đặt hành vi hoàn tất thành thủ công.

Trong chế độ này:

• Adapty vẫn xác thực giao dịch mua và đồng bộ chúng với backend của mình.
• Các giao dịch vẫn chưa được hoàn tất cho đến khi bạn gọi finish() một cách tường minh.

var configBuilder = AdaptyConfiguration
    .builder(withAPIKey: "YOUR_API_KEY")
    .with(transactionFinishBehavior: .manual)

try await Adapty.activate(with: configBuilder.build())   

Khi sử dụng hoàn tất giao dịch thủ công, bạn cần triển khai phương thức delegate onUnfinishedTransaction để xử lý các giao dịch chưa hoàn tất:

extension YourApp: AdaptyDelegate {
    func onUnfinishedTransaction(_ transaction: AdaptyUnfinishedTransaction) async {
        // Perform your custom validation logic here
        
        // When ready, finish the transaction
        await transaction.finish()
    }
}

Để lấy tất cả các giao dịch chưa hoàn tất hiện tại, hãy sử dụng phương thức getUnfinishedTransactions():

let unfinishedTransactions = try await Adapty.getUnfinishedTransactions()