Konfigurasi Pengujian Sandbox iOS

Pengujian pembelian dalam aplikasi di iOS memerlukan pengaturan yang tepat di App Store Connect dan pada perangkat uji Anda. Panduan ini mencakup segala sesuatu yang Anda butuhkan untuk memulai dengan pengujian sandbox.

Prerequisites

• Program Pengembang Apple: Anggota aktif dengan perpanjangan tahunan
• Ketentuan: Menandatangani “Ketentuan Aplikasi Berbayar” dengan informasi perbankan dan pajak selesai
• Proyek Xcode: Dikonfigurasi dengan identifikasi paket yang tepat dan kemampuan

Catatan

Proses pengaturan perbankan dan pajak dapat memakan waktu beberapa jam hingga hari. Pastikan Anda menyelesaikannya sebelum melakukan tes.

Proses Pengaturan

1. Tanda Tangan Perjanjian Aplikasi Berbayar

   Pada App Store Connect, navigasikan ke: Perjanjian, Pajak, dan Perbankan dan lengkapi:

   • Tanda Tangan Perjanjian Aplikasi Berbayar
   • Tambahkan informasi perbankan Anda
   • Lengkapi formulir pajak

   Tunggu Apple menyetujui informasi Anda (hal ini dapat memakan waktu 24-48 jam).

2. Membuat Pengguna Uji Coba Sandbox

   In App Store Connect, go to Pengguna dan Akses > Pengujian Sandbox.

   Klik tombol + Tombol untuk membuat pengujian sandbox baru.

   ImportantGunakan alamat email yang belum terkait dengan ID Apple. Anda bisa menggunakan alias email.

   • iCloud: youremail+test@gmail.com
   • iCloud: youremail+test@icloud.com

   

3. Konfigurasi Perangkat Uji (iOS 12+)

   Mulai dari iOS 12, Anda tidak perlu keluar dari akun iTunes Anda untuk menguji pembelian.

   On perangkat iOS Anda:

   1. Terbuka Pengaturan
   2. Tik App Store
   3. Geser ke bawah
   4. Tik SandBox Account
   5. Masuk dengan akun uji sand box Anda

   Tips

   Metode ini jauh lebih nyaman daripada metode lama keluar dari akun iTunes Anda!

4. Konfigurasi Projek Xcode

   Pastikan projek Xcode Anda memiliki:

   Identifikasi Paket

   • Harus sesuai dengan identifikasi di Pusat Pengembang
   • Harus sesuai dengan identifikasi di App Store Connect

   Kemampuan Pembelian Aplikasi

   1. Pilih projek Anda di Xcode
   2. Pergi ke Tanda Tangan & Kemampuan
   3. Klik + Kemampuan
   4. Tambahkan Pembelian Aplikasi

5. Buat Produk Pembelian Aplikasi

   Dalam App Store Connect, navigasikan ke aplikasi Anda dan buat produk pembelian aplikasi Anda (langganan, konsumabel, dll.).

   Produk harus dalam status “Siap Kirim” setidaknya untuk tes sandbox.

6. Tes Implementasi Anda

   Bangun dan jalankan aplikasi Anda pada perangkat tes. Ketika Anda mencoba membeli, Anda harus melihat:

   [Lingkungan: Sandbox]

   Pengesahan ini menunjukkan Anda berada di lingkungan sandbox dan tidak akan dikenakan biaya uang sungguh.

Catatan Penting

Sifat-Sifat Lingkungan Sandbox

• Tidak ada biaya nyata: Semua pembelian gratis dalam mode sandbox
• Langganan dipercepat: Durasi langganan dipendekkan untuk tes yang lebih cepat
  • Langganan 1 minggu = 3 menit
  • Langganan 1 bulan = 5 menit
  • Langganan 2 bulan = 10 menit
  • Langganan 3 bulan = 15 menit
  • Langganan 6 bulan = 30 menit
  • Langganan 1 tahun = 1 jam
• Limit auto-renewal: Langganan auto-renew hingga 6 kali dalam mode sandbox
• Pembatalan Langsung: Langganan yang dibatalkan berakhir segera

Manajemen Akun Sandbox

• Buat beberapa akun uji untuk skenario yang berbeda
• Gunakan akun uji hanya pada perangkat uji
• Jangan gunakan ID Apple pribadi untuk tes sandbox
• Akun uji dapat membeli produk apa pun tanpa mempertimbangkan wilayah

Menggunakan Tes Sandbox

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

const { isBillingSupported } = await NativePurchases.isBillingSupported();
if (!isBillingSupported) {
  throw new Error('StoreKit not supported on this device');
}

// Fetch products (automatically uses sandbox when available)
const { products } = await NativePurchases.getProducts({
  productIdentifiers: ['premium_monthly'],
  productType: PURCHASE_TYPE.SUBS,
});

// Make test purchase
const transaction = await NativePurchases.purchaseProduct({
  productIdentifier: 'premium_monthly',
  productType: PURCHASE_TYPE.SUBS,
});

console.log('Test purchase successful!', transaction.transactionId);

Verifikasi

Ketika terkonfigurasi dengan benar, Anda seharusnya melihat:

1. Pemberitahuan Sandbox selama pembelian: “[Lingkungan: Sandbox]”
2. Produk memuat successfully
3. Pembelian selesai tidak ada tagihan yang sebenarnya
4. Resi memvalidasi benar
5. Langganan berulang otomatis (dengan kecepatan yang dipercepat)

Troubleshooting

Produk tidak terbuka:

• Pastikan identifikasi paket sesuai dengan App Store Connect
• Periksa apakah perjanjian telah ditandatangani dan disetujui
• Pastikan produk setidaknya dalam status “Siap Kirim”
• Tunggu 2-3 jam setelah membuat produk

“Tidak dapat terhubung ke iTunes Store”:

• Pastikan akun sandbox telah dikonfigurasi dengan benar
• Periksa apakah perangkat terhubung ke internet
• Coba keluar dan masuk kembali ke akun sandbox
• Restart aplikasi

Pembelian gagal diamati:

• Cek konsol Xcode untuk pesan kesalahan
• Pastikan kemampuan Pembelian Aplikasi diaktifkan
• Pastikan alamat email akun sandbox bukan ID Apple yang sebenarnya
• Coba membuat akun uji coba sandbox baru

Kesalahan validasi bukti pembelian:

• Pakai endpoint validasi bukti pembelian sandbox dalam pengujian
• Endpoint produksi: https://buy.itunes.apple.com/verifyReceipt
• Endpoint sandbox: https://sandbox.itunes.apple.com/verifyReceipt
• Plugin pembelian native mengatasi hal ini secara otomatis

Durasi langganan salah:

• Ingat langganan dipercepat dalam sandbox
• Gunakan tabel konversi di atas untuk durasi yang diharapkan
• Langganan otomatis diperbarui maksimal 6 kali di sandbox

“ID Apple ini belum pernah digunakan di iTunes Store”:

• Ini normal untuk akun sandbox baru
• Lanjutkan dengan pembelian untuk mengaktifkan akun
• Hanya terjadi pada penggunaan pertama

Praktik Terbaik

1. Buat beberapa akun uji coba untuk skenario uji coba yang berbeda
2. Uji semua durasi langganan untuk memverifikasi perilaku
3. Pengujian pembatalan dan pembaruan aliran
4. Verifikasi validasi pembayaran berfungsi dengan benar
5. Pengujian pembelian kembali fungsionalitas
6. Periksa peningkatan/turunan langganan tingkah laku
7. Pengujian dengan kondisi jaringan yang buruk

Produksi vs. Sandbox

Fitur	Sandbox	Produksi
Tunggakan sebenarnya	Tidak	Ya
Durasi langganan	Dipercepat	Normal
Batasan auto-renewal	6 kali	Tidak terbatas
Efek pembatalan	Langsung	Akhir periode
Endpoint bukti	URL Sandbox	URL Produksi
Hanya akun uji	Iya	Ya

Sumber Daya Tambahan

Untuk informasi lebih lanjut, silakan mengacu pada dokumentasi resmi Apple StoreKit pada pengujian sandbox.

Teruskan dari Pengaturan Pengujian Sandbox iOS.

Jika Anda menggunakan Pengaturan Pengujian Sandbox iOS. untuk merencanakan persetujuan toko dan distribusi, hubungkannya dengan Menggunakan @capgo/native-purchases untuk kemampuan native di Menggunakan @capgo/native-purchases, @capgo/capacitor-ulasan-dalam-aplikasi untuk detail implementasi di @capgo/capacitor-ulasan-dalam-aplikasi, Menggunakan @capgo/capacitor-ulasan-dalam-aplikasi untuk kemampuan native di Menggunakan @capgo/capacitor-ulasan-dalam-aplikasi, native-market @capgo/capacitor untuk detail implementasi di @capgo/capacitor-native-market, dan Menggunakan @capgo/capacitor-pasar-nasional Untuk kemampuan asli dalam menggunakan @capgo/capacitor-native-market.