Piani di fatturazione mensili di iOS

Apple supporta le sottoscrizioni che fatturano mensilmente mentre impegnano 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 esporre i termini di prezzo, consentire di selezionare il piano di fatturazione mensile durante l'acquisto e restituire i metadati di impegno sulle transazioni e le informazioni di rinnovo.

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

Requisiti

• Configura il piano di fatturazione mensile con impegno di 12 mesi in App Store Connect o in StoreKit Testing in Xcode.
• Costruisci l'app iOS con un Xcode SDK che contiene StoreKit pricingTerms e billingPlanType.
• Esegui su una versione di iOS che supporta i piani di fatturazione di StoreKit con impegno.
• Tieni una scelta di fatturazione standard disponibile per dispositivi o negozi che non restituiscono i termini di prezzo 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 termini di prezzo

Chiamata getProducts() come di consueto. Per i prodotti di sottoscrizione 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',
);

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

Campo	Utilizzalo per
billingDisplayPrice	L'importo di fatturazione 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 il negozio del cliente.
commitmentInfo.period	Il periodo di impegno completo.
subscriptionOffers	Offerte introduttive o promozionali associate al termine di prezzo.

Esempio di copia del muro dei pagamenti:

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' Solo quando hai bisogno di selezionare esplicitamente il piano di fatturazione a fronte standard. Se ometti billingPlanTypeSe non specificato, StoreKit utilizza il suo comportamento di acquisto predefinito per il prodotto.

Consiglio

Assicura di legare lo stato del paywall 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 dell'Impegno

Gli acquisti includono il piano di fatturazione e lo stato di avanzamento dell'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 campi per le decisioni di abilitazione. Utilizza commitmentInfo.expirationDate per spiegare il calendario di impegno completo al cliente.

Note di revisione dell'App Store

• Mostra sia il prezzo di fatturazione ricorrente che il prezzo di impegno totale prima dell'acquisto.
• Fai esplicito il lunghezza di impegno vicino al pulsante di acquisto.
• Utilizza product.title, product.priceString, pricingTerms[].billingDisplayPricee pricingTerms[].commitmentInfo.priceString da StoreKit al posto dei prezzi hardcoded.
• Fornisci azioni di ripristino delle acquisti e di gestione della sottoscrizione sulla schermata di pagamento o sulla schermata account.

Guide correlate

• Crea abbonamenti iOS
• Configura il testing di sabbia iOS
• Linee guida di revisione dell'App Store iOS

Prosegui con i piani di fatturazione mensile di impegno iOS

Se stai utilizzando Piani di fatturazione mensile di impegno iOS per pianificare pagamenti e acquisti, connettilo con Utilizza @capgo/native-purchases per la capacità nativa in Utilizza @capgo/native-purchases, Capgo Pricing per il workflow del prodotto in Capgo Pricing, Sistema di pagamento per i dettagli di implementazione in Sistema di pagamento, @capgo/acquisti nativi per i dettagli di implementazione in @capgo/acquisti nativi, e Avvio rapido per i dettagli di implementazione in Avvio rapido.