Pembelian Nativ

Menggunakan @capgo/native-purchases

Langganan Aplikasi Dalam Aplikasi yang Mudah.

Instalasi

bun add @capgo/native-purchases
bunx cap sync

Apa yang Dapat Diketahui oleh Plugin Ini

• restorePurchases - Mengembalikan pengguna sebelumnya dan menghubungkan ID pengguna aplikasi mereka ke pengguna lain yang juga menggunakan ID tersebut .
• getAppTransaction - Mendapatkan informasi transaksi aplikasi, yang menyediakan detail tentang kapan pengguna pertama kali mengunduh atau membeli aplikasi.
• isEntitledToOldBusinessModel - Membandingkan versi aplikasi asli dari transaksi aplikasi dengan versi target untuk menentukan apakah pengguna berhak atas fitur dari model bisnis yang lebih awal.
• getProducts - Mengisi metadata produk toko, termasuk istilah harga langganan iOS yang didukung.
• purchaseProduct - Membuka proses pembelian untuk produk yang dipilih dan rencana tagihan.

Contoh Penggunaan

restorePurchases

Mengembalikan pengguna sebelumnya dan menghubungkan ID pengguna aplikasi mereka ke pengguna lain yang juga menggunakan ID tersebut .

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

await NativePurchases.restorePurchases();

getAppTransaction

Mendapatkan informasi transaksi aplikasi, yang menyediakan detail tentang kapan pengguna pertama kali mengunduh atau membeli aplikasi.

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

const { appTransaction } = await NativePurchases.getAppTransaction();

// Check if user downloaded before version 2.0.0 (when subscription was added)
if (compareVersions(appTransaction.originalAppVersion, '2.0.0') < 0) {
  // User gets free access - they downloaded before subscriptions
  grantFreeAccess();
}

isEntitledToOldBusinessModel

Membandingkan versi aplikasi asli dari transaksi aplikasi dengan versi target untuk menentukan apakah pengguna berhak atas fitur dari model bisnis yang lebih awal.

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

// Check if user downloaded before version 2.0.0/build 42 (when subscription was added)
const result = await NativePurchases.isEntitledToOldBusinessModel({
  targetVersion: '2.0.0',
  targetBuildNumber: '42'
});

if (result.isOlderVersion) {
  console.log(`User downloaded v${result.originalAppVersion}, granting free access`);
  grantFreeAccess();
}

purchaseProduct

Mulai proses pembelian untuk produk yang ditentukan. Untuk langganan Android, masukkan ID rencana dasar Google Play sebagai parameter. planIdentifier. Untuk langganan iOS yang didukung yang menawarkan pembayaran bulanan dengan komitmen 12 bulan, pass billingPlanType: 'monthly'.

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

await NativePurchases.purchaseProduct({
  productIdentifier: 'com.example.premium.monthly',
  planIdentifier: 'monthly-plan',
  productType: PURCHASE_TYPE.SUBS,
});

Langganan pembayaran bulanan iOS

Pada versi iOS yang didukung, StoreKit dapat menampilkan rencana pembayaran bulanan dengan komitmen 12 bulan melalui pricingTermsTampilkan istilah-istilah ini pada paywall sebelum pembelian:

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

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

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

if (yearlyProduct && monthlyCommitment) {
  console.log('Monthly price:', monthlyCommitment.billingDisplayPrice);
  console.log('Total commitment:', monthlyCommitment.commitmentInfo?.priceString);

  const transaction = await NativePurchases.purchaseProduct({
    productIdentifier: yearlyProduct.identifier,
    productType: PURCHASE_TYPE.SUBS,
    billingPlanType: 'monthly',
  });

  console.log('Billing plan:', transaction.billingPlanType);
  console.log('Commitment ends:', transaction.commitmentInfo?.expirationDate);
}

Referensi Lengkap

• GitHub: https://github.com/Cap-go/capacitor-pembelian-asli/
• Dokumen: /docs/plugins/native-purchases/
• Petunjuk langganan bulanan iOS: /docs/plugins/native-purchases/ios-bulanan-komitmen/

Lanjutkan dari Menggunakan @capgo/native-purchases

Jika Anda menggunakan Menggunakan @capgo/native-purchases untuk merencanakan pembayaran dan pembelian, hubungkannya dengan @capgo/native-purchases untuk detail implementasi di @capgo/native-purchases, Mengawali Pemula untuk detail implementasi di Mengawali Pemula, Harga Capgo untuk alur kerja produk di Harga Capgo, Sistem Pembayaran untuk detail implementasi di Sistem Pembayaran, dan Buku Strategi Penghasilan untuk detail implementasi di Buku Strategi Penghasilan.