Совершение покупок в мобильном приложении через Capacitor SDK

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

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

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

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

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

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);
}

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

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

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

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

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

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);
}

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

Структура MakePurchaseParamsInput включает:

{
  android: {
    subscriptionUpdateParams: {
      oldSubVendorProductId: 'old_product_id',
      prorationMode: 'charge_prorated_price'
    },
    isOfferPersonalized: true
  }
}

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

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

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

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

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

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

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

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

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

Когда пользователь начинает покупку со страницы вашего приложения в App Store и транзакция переходит в приложение, SDK завершает её автоматически — экран покупки Apple появляется сразу, и Adapty обрабатывает транзакцию как обычную покупку. Никакого кода с вашей стороны не требуется.

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

Чтобы самостоятельно управлять завершением покупки — например, сначала показать свой экран — подпишитесь на событие 'onPromotedPurchaseReceived' и передайте продукт в makePromotedPurchase:

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

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

Вызов adapty.removeAllListeners() удаляет слушатель промо-покупок вместе со всеми остальными, после чего SDK снова берёт на себя автоматическое завершение. Зарегистрируйте слушатель повторно, если приложение по-прежнему должно управлять завершением самостоятельно.