Konfigurasi iOS Sandbox Testing
Salin prompt setup yang berisi langkah install dan panduan markdown lengkap untuk plugin ini.
Pengujian in-app purchases di iOS memerlukan konfigurasi yang tepat di App Store Connect dan pada perangkat uji Anda. Panduan ini mencakup semua yang Anda butuhkan untuk memulai pengujian sandbox.
Prerequisites
Bagian berjudul “Prasyarat”- Program Apple Developer: Keanggotaan aktif dengan perpanjangan tahunan
- Perjanjian: “Paid Applications Agreement” sudah ditandatangani dan info bank serta pajak sudah dilengkapi
- Proyek Xcode: Sudah dikonfigurasi dengan bundle identifier dan capabilities yang sesuai
Proses Setup
Bagian berjudul “Proses Setup”-
Tandatangani Paid Applications Agreement
Di App Store Connect, buka Perjanjian, Pajak, dan Bank dan selesaikan:
- Tandatangani Perjanjian Aplikasi Berbayar
- Tambahkan informasi bank Anda
- Lengkapi formulir pajak
Tunggu Apple menyetujui informasi Anda (dapat memakan waktu 24-48 jam).
-
Buat Pengguna Uji Sandbox
Di App Store Connect, buka Pengguna dan Akses > Penguji Sandbox.
Klik + tombol untuk membuat tester sandbox baru.
Penting: Gunakan alamat email yang BELUM terkait dengan Apple ID. Anda dapat menggunakan alias email:
- Gmail:
youremail+test@gmail.com - iCloud:
youremail+test@icloud.com

- Gmail:
-
Konfigurasi Perangkat Uji (iOS 12+)
Mulai dari iOS 12, Anda tidak perlu lagi keluar dari akun iTunes untuk menguji pembelian.
Di perangkat iOS Anda:
- Buka Pengaturan
- Ketuk App Store
- Gulir ke bawah
- Ketuk Akun Sandbox
- Masuk dengan akun tes sandbox Anda
-
Konfigurasi Proyek Xcode
Pastikan proyek Xcode Anda memiliki:
Bundle Identifier
- Harus sesuai dengan identifier di Developer Center Anda
- Harus sesuai dengan identifier di App Store Connect
Kemampuan In-App Purchase
- Pilih proyek Anda di Xcode
- Buka Signing & Capabilities
- Klik + Kapabilitas
- Tambah Pembelian Dalam Aplikasi
-
Buat Produk In-App Purchase
Di App Store Connect, buka aplikasi Anda dan buat produk In-App Purchase (langganan, consumables, dll.).
Produk harus minimal berstatus “Ready to Submit” untuk sandbox testing.
-
Uji Implementasi Anda
Build dan jalankan aplikasi di perangkat uji. Saat mencoba melakukan pembelian, Anda akan melihat:
[Lingkungan: Sandbox]
Konfirmasi ini menandakan Anda berada di lingkungan sandbox dan tidak akan dikenakan biaya sungguhan.
Catatan Penting
Bagian berjudul “Catatan Penting”Karakteristik Lingkungan Sandbox
Bagian berjudul “Karakteristik Lingkungan Sandbox”- Tidak ada tagihan sungguhan: Semua pembelian gratis dalam mode sandbox
- Langganan dipercepat: Durasi langganan diperpendek agar pengujian 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
- Batas perpanjangan otomatis: Langganan diperpanjang otomatis hingga 6 kali di sandbox
- Pembatalan langsung: Langganan yang dibatalkan langsung kedaluwarsa
Manajemen Akun Sandbox
Bagian berjudul “Manajemen Akun Sandbox”- Buat beberapa akun tes untuk berbagai skenario
- Gunakan akun tes hanya di perangkat tes
- Jangan gunakan Apple ID pribadi untuk sandbox testing
- Akun test dapat membeli produk apa pun tanpa batasan wilayah
Menggunakan Sandbox Testing
Bagian berjudul “Menggunakan Sandbox Testing”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 purchaseconst transaction = await NativePurchases.purchaseProduct({ productIdentifier: 'premium_monthly', productType: PURCHASE_TYPE.SUBS,});
console.log('Test purchase successful!', transaction.transactionId);Verifikasi
Bagian berjudul “Verifikasi”Jika sudah dikonfigurasi dengan benar, Anda akan melihat:
- Banner Sandbox saat pembelian: “[Environment: Sandbox]”
- Produk dimuat dengan sukses
- Pembelian selesai tanpa tagihan nyata
- Receipt tervalidasi dengan benar
- Langganan diperpanjang otomatis (dengan laju dipercepat)
Pemecahan Masalah
Bagian berjudul “Troubleshooting”Produk tidak dimuat:
- Pastikan bundle identifier sesuai dengan App Store Connect
- Cek apakah perjanjian sudah ditandatangani dan disetujui
- Pastikan status produk minimal “Ready to Submit”
- Tunggu 2-3 jam setelah membuat produk
“Tidak dapat terhubung ke iTunes Store”:
- Pastikan akun sandbox sudah dikonfigurasi dengan benar
- Pastikan perangkat terhubung ke internet
- Coba sign out lalu sign in kembali ke akun sandbox
- Restart aplikasi
Pembelian gagal tanpa pesan error:
- Cek konsol Xcode untuk melihat pesan error
- Pastikan In-App Purchase capability sudah diaktifkan
- Pastikan email akun sandbox bukan Apple ID asli
- Coba buat akun test sandbox baru
Error validasi receipt:
- Gunakan endpoint validasi receipt sandbox saat testing
- Endpoint produksi:
https://buy.itunes.apple.com/verifyReceipt - Endpoint sandbox:
https://sandbox.itunes.apple.com/verifyReceipt - Plugin native-purchases menanganinya secara otomatis
Durasi langganan salah:
- Ingat bahwa durasi langganan dipercepat di sandbox
- Gunakan tabel konversi di atas untuk estimasi durasi
- Langganan auto-renew maksimal 6 kali di sandbox
“Apple ID ini belum pernah digunakan di iTunes Store”:
- Ini normal untuk akun sandbox baru
- Lanjutkan pembelian untuk mengaktifkan akun
- Hanya terjadi pada penggunaan pertama
Praktik Terbaik
Bagian berjudul “Praktik Terbaik”- Buat beberapa akun uji untuk skenario uji yang berbeda
- Uji semua durasi langganan untuk memverifikasi perilaku
- Uji pembatalan dan perpanjangan flows
- Verifikasi validasi receipt berjalan dengan benar
- Uji pemulihan pembelian fungsionalitas
- Periksa upgrade/downgrade langganan perilaku
- Uji dengan kondisi jaringan buruk
Produksi vs. Sandbox
Bagian berjudul “Produksi vs. Sandbox”| Fitur | Sandbox | Produksi |
|---|---|---|
| Pembayaran nyata | Tidak | Ya |
| Durasi langganan | Dipercepat | Normal |
| Batas perpanjangan otomatis | 6 kali | Tanpa batas |
| Efek pembatalan | Segera | Akhir periode |
| Endpoint receipt | URL Sandbox | URL Produksi |
| Hanya akun uji | Ya | Tidak |
Sumber daya tambahan
Bagian berjudul “Sumber daya tambahan”Untuk detail lebih lanjut, lihat dokumentasi Apple StoreKit resmi tentang pengujian sandbox.
Lanjutkan dari Konfigurasi Pengujian Sandbox iOS
Bagian berjudul “Lanjut dari Konfigurasi Pengujian Sandbox iOS”Jika Anda menggunakan Konfigurasi iOS Sandbox Testing untuk merencanakan persetujuan store dan distribusi, hubungkan dengan Menggunakan @capgo/native-purchases untuk kemampuan native saat menggunakan @capgo/native-purchases, @capgo/capacitor-in-app-review untuk detail implementasi di @capgo/capacitor-in-app-review, Menggunakan @capgo/capacitor-in-app-review untuk kapabilitas native di bagian Menggunakan @capgo/capacitor-in-app-review, @capgo/capacitor-native-market untuk detail implementasi di @capgo/capacitor-native-market, dan Menggunakan @capgo/capacitor-native-market untuk kemampuan native di Menggunakan @capgo/capacitor-native-market.