Piani di fatturazione mensili per iOS

L'Apple supporta le sottoscrizioni che fatturano mensilmente impegnando il cliente a un termine più lungo di 12 mesi. Quando StoreKit e l'OS in esecuzione supportano questo piano di fatturazione, @capgo/native-purchases esporge i termini di prezzo, consente di selezionare il piano di fatturazione mensile durante l'acquisto e restituisce i metadati di impegno sui trasazioni e le informazioni di rinnovo.

Usa questo per offrire sottoscrizioni annuali dove gli utenti preferiscono pagamenti mensili, ma desiderano comunque la retention e la prevedibilità di un termine annuale impegnativo.

Requisiti

• Configura il piano di fatturazione mensile con impegno di 12 mesi nel App Store Connect o nel StoreKit Testing in Xcode.
• Costruisci l'app iOS con un Xcode SDK che contiene StoreKit pricingTerms e billingPlanType.
• Esegui su una versione iOS che supporta i piani di fatturazione di StoreKit.
• Conserva un'opzione di fatturazione standard disponibile per dispositivi o negozi che non restituiscono termini di fatturazione di impegno.

Nota

Il JavaScript API è sicuro da chiamare su tutte le piattaforme. Le piattaforme non supportate semplicemente non restituiranno pricingTerms, e Android ignora billingPlanType.

Carica e visualizza i termini di fatturazione

Chiamare getProducts() Come di consueto. Per i prodotti di abbonamento iOS supportati, ogni prodotto può includere pricingTerms.

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';

const { products } = await NativePurchases.getProducts({
  productIdentifiers: ['com.example.app.premium.yearly'],
  productType: PURCHASE_TYPE.SUBS,
});

const premiumYearly = products.find(
  (product) => product.identifier === 'com.example.app.premium.yearly',
);
const monthlyCommitment = premiumYearly?.pricingTerms?.find(
  (term) => term.billingPlanType === 'monthly',
);

Rendere i valori forniti dalla store al posto dei prezzi hardcoded:

Campo	Utilizzalo per
billingDisplayPrice	Il prezzo mensile della fattura ricorrente visualizzato all'utente, ad esempio il carico mensile.
billingPeriod	Il calendario di fatturazione per il prezzo di fatturazione visualizzato.
commitmentInfo.priceString	Il prezzo totale di impegno formattato per la vetrina dell'utente.
commitmentInfo.period	La durata dell'impegno completo.
subscriptionOffers	Offerte introduttive o promozionali legate al termine di prezzo.

Esempio di copia del paywall:

function commitmentLabel(term: NonNullable<typeof monthlyCommitment>) {
  const total = term.commitmentInfo?.priceString;
  return total
    ? `${term.billingDisplayPrice} billed monthly, ${total} total commitment`
    : term.billingDisplayPrice;
}

Acquista il Piano di impegno mensile

Quando l'utente seleziona il piano di impegno mensile, passa billingPlanType: 'monthly'.

const transaction = await NativePurchases.purchaseProduct({
  productIdentifier: 'com.example.app.premium.yearly',
  productType: PURCHASE_TYPE.SUBS,
  billingPlanType: 'monthly',
  appAccountToken: userStoreUuid,
});

Usa billingPlanType: 'upFront' utilizza solo quando hai bisogno di selezionare esplicitamente il piano di fatturazione a fronte standard. Se ometti billingPlanType, StoreKit utilizza il comportamento di acquisto predefinito per il prodotto.

Tip

Mantieni lo stato della paywall legato al termine di prezzo che l'utente ha selezionato. Se pricingTerms è mancante, nascondi l'opzione di impegno e mostra il pulsante di acquisto della sottoscrizione regolare.

Leggi i Metadati di Impegno

I transazioni includono il piano di fatturazione e lo stato di impegno quando StoreKit lo fornisce:

if (transaction.billingPlanType === 'monthly') {
  console.log('Current billing period:', transaction.commitmentInfo?.billingPeriodNumber);
  console.log('Total billing periods:', transaction.commitmentInfo?.totalBillingPeriods);
  console.log('Commitment ends:', transaction.commitmentInfo?.expirationDate);
  console.log('Commitment total:', transaction.commitmentInfo?.price);
}

L'informazione di rinnovo può includere lo stato di impegno successivo:

const { purchases } = await NativePurchases.getPurchases({
  productType: PURCHASE_TYPE.SUBS,
  onlyCurrentEntitlements: true,
});

for (const purchase of purchases) {
  const commitment = purchase.renewalInfo?.commitmentInfo;
  if (!commitment) continue;

  console.log('Renews into another commitment:', commitment.willAutoRenew);
  console.log('Next billing plan:', commitment.renewalBillingPlanType);
  console.log('Next renewal date:', commitment.renewalDate);
}

Utilizza il livello superiore expirationDate e isActive Utilizza i campi di alto livello commitmentInfo.expirationDate Spiegare il calendario di impegno completo al cliente.

Nota di Valutazione App Store

• Mostra sia il prezzo di fatturazione ricorrente che il prezzo totale di impegno prima dell'acquisto.
• Fai esplicito la lunghezza del impegno vicino al pulsante di acquisto.
• Usa product.title, product.priceString, pricingTerms[].billingDisplayPrice, e pricingTerms[].commitmentInfo.priceString dal StoreKit invece dei prezzi hardcoded.
• Fornisci azioni di ripristino acquisti e gestione abbonamenti sulla schermata di pagamento o sulla schermata account.

Guide correlate

• Creare sottoscrizioni iOS
• Configura il testing di sandbox iOS
• Linee guida di revisione App Store iOS

Continua con i piani di fatturazione mensile di impegno iOS

Se stai utilizzando Piani di fatturazione mensili di impegno per iOS per pianificare i pagamenti e le vendite, connettilo con Utilizzare @capgo/acquisti nativi per la capacità nativa in Utilizzare @capgo/acquisti nativi Capgo Prezzi per il flusso di lavoro del prodotto in Capgo Prezzi Sistema di pagamento per la dettaglio di implementazione in Sistema di pagamento @capgo/acquisti nativi per il dettaglio di implementazione in @capgo/acquisti nativi, e Avvio rapido per il dettaglio di implementazione in Avvio rapido.