Rencana Billing Bulanan iOS

Apple mendukung langganan yang membayar setiap bulan sementara mempertahankan pelanggan untuk jangka waktu 12 bulan. Ketika StoreKit dan OS yang berjalan mendukung rencana pembayaran ini, @capgo/native-purchases menampilkan syarat harga, memungkinkan Anda memilih rencana pembayaran bulanan selama pembelian, dan mengembalikan metadata komitmen pada transaksi dan informasi perpanjangan.

Gunakan ini untuk tawaran langganan tahunan di mana pengguna lebih suka pembayaran bulanan tetapi Anda masih ingin mempertahankan dan memprediksi komitmen tahunan.

Persyaratan

• Konfigurasi rencana pembayaran bulanan dengan komitmen 12 bulan di App Store Connect atau di StoreKit Testing di Xcode.
• Buat aplikasi iOS dengan Xcode SDK yang mengandung StoreKit pricingTerms dan billingPlanType.
• Jalankan pada versi iOS yang mendukung rencana pembayaran komitmen StoreKit.
• Tetapkan opsi pembayaran standar untuk perangkat atau toko yang tidak mengembalikan syarat harga komitmen.

Catatan

JavaScript API dapat diakses dengan aman di semua platform. Platform yang tidak didukung akan tidak mengembalikan apa-apa pricingTerms, dan Android mengabaikannya billingPlanType.

Muat dan Tampilkan Ketentuan Harga

Panggil getProducts() seperti biasa. Untuk produk langganan iOS yang didukung, setiap produk dapat mencakup 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',
);

Tampilkan nilai yang disediakan toko alih-alih harga yang dikodekan secara keras:

Bidang	Gunakan untuk
billingDisplayPrice	Jumlah tagihan berulang yang ditampilkan kepada pengguna, misalnya biaya bulanan.
billingPeriod	Frekuensi tagihan untuk harga tagihan yang ditampilkan.
commitmentInfo.priceString	Harga total komitmen yang diformat untuk toko penjualan pengguna.
commitmentInfo.period	Lama komitmen penuh.
subscriptionOffers	Tawaran promosi atau penawaran spesial yang terkait dengan istilah harga.

Contoh teks pemblokiran bayar:

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

Beli Rencana Komitmen Bulanan

Ketika pengguna memilih rencana komitmen bulanan, kirim billingPlanType: 'monthly'.

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

Gunakan billingPlanType: 'upFront' hanya ketika Anda perlu memilih secara eksplisit rencana pembayaran muka standar. Jika Anda mengabaikan billingPlanType, StoreKit menggunakan perilaku pembelian defaultnya untuk produk tersebut.

Tip

Tetapkan status paywall terkait dengan istilah harga yang diklik oleh pengguna. Jika pricingTerms kosong, sembunyikan opsi komitmen dan tampilkan tombol pembelian langganan reguler.

Read Commitment Metadata

Transaksi mencakup rencana pembayaran dan kemajuan komitmen ketika StoreKit menyediakannya:

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

Info perpanjangan dapat mencakup keadaan komitmen berikutnya:

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

Pakai tingkat atas expirationDate dan isActive bidang-bidang untuk keputusan hak istimewa. Gunakan commitmentInfo.expirationDate untuk menjelaskan timeline komitmen penuh kepada pelanggan.

Catatan Ulasan App Store

• Tampilkan baik harga tagihan berulang dan harga komitmen total sebelum pembelian.
• Buat panjang komitmen eksplisit dekat tombol pembelian.
• Gunakan product.title, product.priceString, pricingTerms[].billingDisplayPricedan pricingTerms[].commitmentInfo.priceString dari StoreKit bukan harga yang dihardcode.
• Berikan aksi memulihkan pembelian dan mengelola langganan pada layar pembayaran atau layar akun.

Buku Panduan Terkait

• Buat Langganan iOS
• Konfigurasi Pengujian Sandbox iOS
• Pedoman Ulasan App Store iOS

Lanjutkan dari Rencana Pembayaran Bulanan iOS

Jika Anda menggunakan Rencana Pembayaran Bulanan iOS untuk merencanakan pembayaran dan pembelian, hubungkannya dengan Menggunakan @capgo/native-purchases untuk kemampuan native di Menggunakan @capgo/native-purchases, Capgo Pricing untuk alur kerja produk di Capgo Pricing, Sistem Pembayaran untuk detail implementasi di Sistem Pembayaran, @capgo/native-purchases untuk detail implementasi di @capgo/native-purchases, dan Mulaikan untuk detail implementasi di Mulaikan.