Langsung ke konten

Konfigurasi iOS Sandbox Testing

GitHub

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.

  • 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
  1. 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).

  2. 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

    Buat tester sandbox

  3. Konfigurasi Perangkat Uji (iOS 12+)

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

    Di perangkat iOS Anda:

    1. Buka Pengaturan
    2. Ketuk App Store
    3. Gulir ke bawah
    4. Ketuk Akun Sandbox
    5. Masuk dengan akun tes sandbox Anda
  4. 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

    1. Pilih proyek Anda di Xcode
    2. Buka Signing & Capabilities
    3. Klik + Kapabilitas
    4. Tambah Pembelian Dalam Aplikasi
  5. 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.

  6. 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.

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

Jika sudah dikonfigurasi dengan benar, Anda akan melihat:

  1. Banner Sandbox saat pembelian: “[Environment: Sandbox]”
  2. Produk dimuat dengan sukses
  3. Pembelian selesai tanpa tagihan nyata
  4. Receipt tervalidasi dengan benar
  5. Langganan diperpanjang otomatis (dengan laju dipercepat)

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
  1. Buat beberapa akun uji untuk skenario uji yang berbeda
  2. Uji semua durasi langganan untuk memverifikasi perilaku
  3. Uji pembatalan dan perpanjangan flows
  4. Verifikasi validasi receipt berjalan dengan benar
  5. Uji pemulihan pembelian fungsionalitas
  6. Periksa upgrade/downgrade langganan perilaku
  7. Uji dengan kondisi jaringan buruk
FiturSandboxProduksi
Pembayaran nyataTidakYa
Durasi langgananDipercepatNormal
Batas perpanjangan otomatis6 kaliTanpa batas
Efek pembatalanSegeraAkhir periode
Endpoint receiptURL SandboxURL Produksi
Hanya akun ujiYaTidak

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.