Pembayaran Stripe

1Yang didapat aplikasi Anda#

Memungkinkan aplikasi yang Anda buat menagih uang sungguhan - paywall, upgrade 'Pro', tombol beli - lewat Stripe Checkout.

Ini akun Stripe ANDA: kunci Anda, uang Anda, dibayarkan langsung kepada Anda. AppMint tidak mengambil potongan dan tidak menanggung kewajiban pembayaran (tanpa Stripe Connect). Anda menghubungkan Stripe SEKALI di Pengaturan; setiap aplikasi yang Anda buat memakainya kembali - Anda hanya menjelaskan apa yang dijual, tanpa memasukkan ulang kunci.

AI menulis seluruh kode pembayaran. Secret key Anda tidak pernah dikirim di dalam aplikasi - tersimpan di backend Supabase Anda.

2Hubungkan Supabase dulu (wajib)#

Pembayaran Stripe memerlukan server aman untuk menyimpan secret key Anda dan mengonfirmasi pembayaran - server itu adalah proyek Supabase Anda. Jadi hubungkan dan aktifkan Supabase dulu (Pengaturan → BACKEND - SUPABASE) - bab '🗄️ Supabase Backend (Connect It Once)' di bagian atas panduan ini menjelaskannya.

Jika Supabase belum aktif, Anda akan melihat 'Stripe keys saved, but payments also need Supabase active'. AppMint mengirim secret Stripe Anda ke fungsi Supabase secara otomatis saat deploy - tidak pernah dimasukkan ke aplikasi yang dibuat.

3Dapatkan kunci Stripe Anda (mulai dari mode uji)#

Di komputer:

1. Buka Stripe Dashboard dan tetap di mode test / sandbox selama Anda membangun (Stripe kini menyebut lingkungan uji sebagai 'sandbox'; akun lama menampilkan sakelar Test/Live). Tidak ada tagihan sungguhan di sini.
2. Buka Developers → API keys.
3. Salin 'Publishable key' (diawali pk_test_…) dan tampilkan + salin 'Secret key' (diawali sk_test_…).

Gunakan Secret key standar (sk_…), bukan Restricted key (rk_…) - AppMint memvalidasi dan mengirim secret sk_. Tidak perlu persetujuan merchant untuk membangun dan menguji seluruh alur sebelum mengaktifkan pembayaran live.

Buka Stripe API keys →

4Hubungkan Stripe di AppMint#

Buka AI Studio → Pengaturan → gulir ke 'PAYMENTS - STRIPE (OPTIONAL)' → 'CONNECT STRIPE (YOUR ACCOUNT)':

1. Biarkan 'Live mode' MATI dulu (mati = Test).
2. Tempelkan publishable key Anda ke kolom pk_test_….
3. Tempelkan secret key Anda ke kolom sk_test_… (disimpan terenkripsi di perangkat ini).
4. Aktifkan 'Enable Stripe payments for generated apps'.
5. Ketuk 'Validate & save Stripe keys'. AppMint memeriksa format, memastikan kedua kunci berada di mode yang sama, dan memverifikasi secret ke Stripe. Jika berhasil, Anda akan melihat '● Connected (TEST)'.

5Yang dipasang AppMint untuk Anda#

Saat Anda membuat aplikasi dengan pembayaran, AppMint mengurus semua pemasangannya secara otomatis - Anda tidak perlu menyentuh dasbor Supabase atau Stripe:

• Mengirim STRIPE_SECRET_KEY Anda ke Supabase Edge Functions (terenkripsi, hanya di sisi server).
• Men-deploy fungsi 'create-checkout' (memulai sesi Stripe Checkout) dan fungsi 'stripe-webhook' (mengonfirmasi pembayaran).
• Mendaftarkan webhook ke Stripe dan menyimpan secret penandatanganannya.
• Membuat tabel 'entitlements' agar aplikasi tahu siapa yang sudah membayar.

Publishable key (pk_) adalah satu-satunya nilai Stripe yang ikut dikirim di dalam aplikasi - kunci itu aman untuk bersifat publik.

6Jelaskan paywall Anda - AI yang membuatnya#

Cukup katakan apa yang Anda mau dengan bahasa sehari-hari. AI menambahkan tombol beli, panggilan checkout, dan mengunci fitur berbayar untuk Anda:

• 'Tagih $5 sekali bayar untuk membuka tema Pro.'
• 'Langganan $9/bulan yang menghilangkan iklan.'
• 'Jual PDF yang bisa diunduh seharga $19.'

Anda tidak pernah menempelkan kunci atau harga ke chat sebagai konfigurasi - hanya maksudnya. Akses baru terbuka setelah Stripe mengonfirmasi pembayaran lewat webhook, bukan dari flag 'sudah bayar' di sisi klien, sehingga tidak bisa dipalsukan.

7Uji pembayaran dari awal sampai akhir#

Selama mode Test, tidak ada uang sungguhan yang berpindah. Jalankan alur lengkapnya:

1. Buka aplikasi Anda dan ketuk tombol beli/upgrade.
2. Di halaman Stripe Checkout, bayar dengan kartu uji:

 4242 4242 4242 4242, any future expiry, any CVC, any ZIP.

1. Anda dikembalikan ke aplikasi dan fitur berbayar terbuka.
2. Periksa Stripe Dashboard (mode Test) → Payments - Anda akan melihat transaksi ujinya.

Jika fitur terbuka, webhook dan entitlements Anda sudah terpasang dengan benar.

4242 4242 4242 4242   exp: any future date   CVC: any 3 digits

8Go Live saat Anda siap#

1. Aktifkan akun Stripe Anda untuk pembayaran live (Stripe Dashboard → 'Activate' / lengkapi data bisnis).
2. Di Stripe, beralih dari sandbox/test ke mode live dan salin kunci LIVE Anda (pk_live_… dan sk_live_…) dari Developers → API keys.
3. Di AppMint → Pengaturan → Pembayaran: aktifkan 'Live mode', tempelkan kunci pk_live_/sk_live_, lalu ketuk 'Validate & save'. Lencana berubah menjadi '● Connected (LIVE)'.
4. Build ulang aplikasi Anda.

AppMint mencegah pencampuran kunci test dan live, dan berpindah mode akan mengarahkan ulang secret yang sudah di-deploy - test dan live tidak pernah ada bersamaan di satu aplikasi, jadi Anda tidak bisa tanpa sengaja merilis kunci test.

9Jika ada yang tidak berfungsi#

• 'Stripe keys saved, but payments also need Supabase active' → aktifkan Supabase terlebih dahulu (langkah 2).

• 'Anda memilih TEST tetapi kuncinya LIVE' (atau sebaliknya) → sakelar mode harus cocok dengan awalan kunci Anda (pk_test/sk_test vs pk_live/sk_live).

• 'Stripe rejected the key' → secret key salah atau sudah dicabut. Salin ulang dari Developers → API keys.

• Pembayaran berhasil tetapi fitur tetap terkunci → webhook tidak sampai ke Supabase. Build ulang/deploy ulang agar AppMint mendaftarkan ulang webhook, dan pastikan proyek Supabase aplikasi adalah yang Anda hubungkan.

• Tidak bisa mengaktifkan akun live → Stripe TIDAK menerima merchant di beberapa negara (termasuk India). Mode uji tetap berfungsi di mana saja untuk membangun; untuk pembayaran live di sana, Anda memerlukan negara yang didukung Stripe atau penyedia lain.