Gestion avancée des transactions dans le SDK iOS

La gestion avancée des transactions dans Adapty vous donne plus de contrôle sur la façon dont les transactions sont gérées, vérifiées et finalisées.

Elle introduit trois fonctionnalités optionnelles qui fonctionnent ensemble :

Ensemble, ces outils vous permettent de construire des flux de validation personnalisés robustes pendant qu’Adapty continue de synchroniser les transactions avec son backend.

Assigner appAccountToken

appAccountToken est un UUID qui vous permet de lier les transactions de l’App Store à l’identité interne de vos utilisateurs.
StoreKit associe ce token à chaque transaction, ce qui permet à votre backend de faire correspondre les données App Store à vos utilisateurs.

Utilisez un UUID stable généré par utilisateur et réutilisez-le pour le même compte sur tous les appareils. Cela garantit que les achats et les notifications App Store restent correctement liés.

Vous pouvez définir le token de deux façons — lors de l’activation du SDK ou lors de l’identification de l’utilisateur.

// 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
    }
}

Accéder à la représentation JWS

Lorsque vous effectuez un achat, le résultat inclut la transaction Apple au format JWS Compact Serialization. Vous pouvez transmettre cette valeur à votre backend pour une validation ou une journalisation indépendante.

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

Contrôler le comportement de finalisation des transactions

Par défaut, Adapty finalise automatiquement les transactions StoreKit après validation. Si vous devez différer la finalisation jusqu’à ce que votre backend confirme le succès, définissez le comportement de finalisation sur manuel.

Dans ce mode :

• Adapty valide quand même les achats et les synchronise avec son backend.
• Les transactions restent non finalisées jusqu’à ce que vous appeliez explicitement finish().

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

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

Lorsque vous utilisez la finalisation manuelle des transactions, vous devez implémenter la méthode delegate onUnfinishedTransaction pour gérer les transactions non finalisées :

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

Pour obtenir toutes les transactions non finalisées en cours, utilisez la méthode getUnfinishedTransactions() :

let unfinishedTransactions = try await Adapty.getUnfinishedTransactions()