Совершение покупок в мобильном приложении с Flutter SDK

Отображение пейволов в мобильном приложении — важный шаг для предоставления пользователям доступа к премиум-контенту или услугам. Однако сам по себе показ пейвола поддерживает покупки только в том случае, если Adapty отрисовывает экран — то есть это флоу или пейвол из старого Paywall Builder.

Если вы отрисовываете экран самостоятельно в своём коде, для завершения покупки и открытия нужного контента необходимо использовать отдельный метод .makePurchase(). Именно через него пользователи взаимодействуют с пейволами и совершают нужные им транзакции.

Если на вашем пейволе настроен активный promotional offer для продукта, который пользователь пытается купить, Adapty автоматически применит его в момент покупки.

Убедитесь, что вы выполнили начальную настройку, не пропустив ни одного шага. Без неё мы не сможем валидировать покупки.

Совершение покупки

try {
  final purchaseResult = await Adapty().makePurchase(product: product);
    switch (purchaseResult) {
      case AdaptyPurchaseResultSuccess(profile: final profile):
        if (profile.accessLevels['premium']?.isActive ?? false) {
          // Grant access to the paid features
        }
        break;
      case AdaptyPurchaseResultPending():
        break;
      case AdaptyPurchaseResultUserCancelled():
        break;
      default:
        break;
    }
} on AdaptyError catch (adaptyError) {
    // Handle the error
} catch (e) {
    // Handle the error
}

Параметры запроса:

Параметры ответа:

Смена подписки при совершении покупки

Когда пользователь выбирает новую подписку вместо продления текущей, поведение зависит от стора:

• В App Store подписка обновляется автоматически в рамках группы подписок. Если пользователь покупает подписку из одной группы, уже имея активную из другой, обе подписки будут активны одновременно.
• В Google Play подписка не обновляется автоматически. Переключение нужно реализовать в коде вашего приложения, как описано ниже.

Чтобы заменить подписку на другую в Android, вызовите метод .makePurchase() с дополнительным параметром:

try {
  final subscriptionUpdateParams = AdaptyAndroidSubscriptionUpdateParameters(
    'OLD_PRODUCT_ID',
    AdaptyAndroidSubscriptionUpdateReplacementMode.immediateWithTimeProration,
  );

  final result = await Adapty().makePurchase(
    product: product,
    parameters: AdaptyPurchaseParameters(
      subscriptionUpdateParams: subscriptionUpdateParams,
    ),
  );
  
  // successful cross-grade
} on AdaptyError catch (adaptyError) {
  // Handle the error
} catch (e) {
  // Handle the error
}

Дополнительный параметр запроса:

Подробнее о подписках и режимах замены можно прочитать в документации Google для разработчиков:

• О режимах замены
• Рекомендации Google по режимам замены
• Режим замены CHARGE_PRORATED_PRICE. Примечание: этот метод доступен только для повышения уровня подписки. Понижение уровня не поддерживается.
• Режим замены DEFERRED. Примечание: реальное изменение подписки произойдёт только по окончании текущего расчётного периода.

Активация промокодов в iOS

Чтобы показать экран активации кода в приложении:

try {
  await Adapty().presentCodeRedemptionSheet();
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
  // handle the error
}

Продвигаемые встроенные покупки из App Store

Когда пользователь начинает покупку со страницы вашего продукта в App Store и транзакция переходит в ваше приложение, SDK передаёт продукт в didReceivePromotedPurchaseStream. Подпишитесь на поток и передайте продукт в makePromotedPurchase:

Adapty().didReceivePromotedPurchaseStream.listen((product) async {
  try {
    final result = await Adapty().makePromotedPurchase(product: product);
    // process the purchase result
  } on AdaptyError catch (adaptyError) {
    // handle the error
  } catch (e) {
    // handle the error
  }
});

Подпишитесь на события сразу после activate при запуске приложения — это гарантирует, что слушатель будет зарегистрирован до того, как придёт уведомление об акционной покупке. didReceivePromotedPurchaseStream — это широковещательный поток без воспроизведения: продукт, доставленный в отсутствие слушателя, будет потерян.

makePromotedPurchase не принимает параметры покупки, поскольку акционный продукт поступает из App Store, а не с пейвола, и не несёт контекста пейвола. Метод возвращает тот же AdaptyPurchaseResult, что и makePurchase.

Если продвигаемый продукт содержит подписочное предложение, SDK применяет его при покупке автоматически. Предложение считывается из намерения покупки App Store, которое доступно начиная с iOS 18.0. На iOS 16.4–17.x покупка выполняется по базовой цене.

Управление предоплаченными планами (Android)

Если пользователи вашего приложения могут приобретать предоплаченные планы (например, купить невозобновляемую подписку на несколько месяцев), вы можете включить отложенные транзакции для предоплаченных планов.

await Adapty().activate(
  configuration: AdaptyConfiguration(apiKey: 'YOUR_PUBLIC_SDK_KEY')
    ..withGoogleEnablePendingPrepaidPlans(true),
);