Hubungkan Stripe ke aplikasi MonstarX Anda

Q: Bisakah saya mencoba pembayaran tanpa kartu sungguhan?

Bisa. Hubungkan dengan Sandbox (kunci uji) dan bayar dengan kartu uji 4242 4242 4242 4242, tanggal apa pun di masa depan, dan CVC apa pun. Tidak ada uang yang berpindah.

Q: Bagaimana cara beralih dari pembayaran uji ke pembayaran sungguhan?

Klik Perbarui kunci di baris Stripe, atur Lingkungan ke Produksi (kunci transaksi nyata), tempel kunci live Anda, klik Simpan kunci, lalu terbitkan ulang aplikasi.

Q: Mengapa checkout saya menyatakan Stripe belum terhubung?

Kuncinya belum dimasukkan, atau sudah dihapus. Buka Backend → Cloud dan hubungkan Stripe; pratinjau akan dimulai ulang dengan kunci tersebut.

SingkatnyaStripe memungkinkan aplikasi Anda menerima pembayaran sungguhan. Tempel kunci Stripe Anda di Backend → Cloud (atau di kartu yang ditampilkan MonstarX di percakapan). Pilih Sandbox (kunci uji) selama mencoba-coba, dan Produksi (kunci transaksi nyata) saat pelanggan sungguhan membayar. MonstarX menuliskan checkout-nya untuk Anda.

Terima pembayaran kartu, langganan, dan checkout di aplikasi Anda.

Jenis: Untuk aplikasi Anda
Kategori: Pembayaran dan penagihan
Hubungkan dengan: Kunci API

Stripe adalah perusahaan pembayaran: Stripe mengurus formulir kartu, urusan dengan bank, dan tanda terima, lalu mencairkan uangnya ke rekening bank Anda. Hubungkan Stripe, dan aplikasi Anda dapat menjual sesuatu — paket kelas, produk, keanggotaan bulanan — dengan halaman checkout aman yang dijalankan oleh Stripe.

Apa yang bisa Anda bangun dengan Stripe?

Tombol “Beli sekarang” yang membuka halaman checkout Stripe dan mengembalikan pelanggan ke aplikasi Anda setelah mereka membayar.
Paket dan bundel, seperti “5 kelas seharga $90”, yang membuka akses ke sesuatu di aplikasi setelah dibayar.
Langganan bulanan atau tahunan untuk anggota atau paket berbayar.
Riwayat pesanan untuk setiap pelanggan, dan halaman admin yang menampilkan daftar pembayaran.
Tindak lanjut otomatis, seperti menandai pesanan sebagai lunas dan mengirim tanda terima lewat email, saat Stripe mengonfirmasi pembayaran.

Sebelum memulai

Akun Stripe. Membuat akun gratis; Stripe memotong biaya dari setiap pembayaran yang berhasil (lihat harga Stripe). MonstarX tidak menambahkan biaya apa pun.
Untuk pengujian, tidak perlu apa-apa lagi: setiap akun Stripe dapat memakai sandbox, salinan latihan dari akun Anda tempat tidak ada uang sungguhan yang berpindah.
Untuk pembayaran sungguhan, Stripe meminta Anda mengaktifkan akun terlebih dahulu — detail bisnis Anda dan rekening bank tujuan pencairan.

Apa itu Sandbox dan Produksi?

Stripe memberi Anda dua set kunci, dan MonstarX menanyakan set mana yang Anda tempel lewat pilihan Lingkungan:

Lingkungan	Awalan kunci	Yang terjadi
Sandbox (kunci uji)	`sk_test_…` dan `pk_test_…`	Pembayaran pura-pura dengan nomor kartu uji. Tidak ada kartu sungguhan yang ditagih dan tidak ada uang yang berpindah. Pakai selama membangun.
Produksi (kunci transaksi nyata)	`sk_live_…` dan `pk_live_…`	Kartu sungguhan, uang sungguhan, dicairkan ke rekening bank Anda. Pakai saat pelanggan sungguhan membayar.

Apa yang Anda buat di satu lingkungan tidak ada di lingkungan lain: produk, harga, pelanggan, dan pembayaran yang dibuat di sandbox tetap berada di sandbox.

Bagaimana cara membayar dengan kartu uji?

Di sandbox, checkout Stripe menerima kartu uji resmi yang dicantumkan Stripe. Gunakan tanggal kedaluwarsa apa pun di masa depan (seperti 12/34), CVC tiga digit apa pun, dan kode pos apa pun:

Nomor kartu	Yang terjadi
`4242 4242 4242 4242`	Pembayaran berhasil.
`4000 0000 0000 0002`	Kartu ditolak, sehingga Anda dapat melihat apa yang dilihat pelanggan saat pembayaran gagal.
`4000 0025 0000 3155`	Bank meminta pemeriksaan tambahan (3D Secure) sebelum pembayaran diproses.

Jangan pernah mengetik nomor kartu sungguhan di checkout sandbox. Stripe mencantumkan lebih banyak kartu uji di panduan pengujiannya.

Dapatkan kunci Anda

Masuk ke Stripe Dashboard.
Untuk menguji, buka sandbox dari menu akun di kiri atas. Untuk transaksi nyata, beralihlah ke live mode.
Buka API keys (di bagian Developers). Salin Publishable key, lalu tampilkan dan salin Secret key.

Hubungkan di MonstarX

Saat Anda meminta fitur pembayaran, MonstarX biasanya menampilkan kartu Hubungkan Stripe di percakapan dengan kolom yang sama. Anda juga dapat menghubungkannya sendiri:

Buka proyek Anda, klik Backend di bilah atas, lalu Cloud.
Di bagian Konektor, klik Hubungkan di samping Stripe.
Pilih Lingkungan: Sandbox (kunci uji) atau Produksi (kunci transaksi nyata).
Tempel Kunci rahasia dan Kunci publik. Biarkan Rahasia penandatanganan webhook kosong untuk saat ini.
Klik Hubungkan Stripe. Baris tersebut menampilkan Terhubung · sandbox (atau Terhubung · produksi), dan pratinjau Anda dimulai ulang dengan kunci tersebut.

MonstarX tidak memeriksa apakah kunci cocok dengan lingkungan yang Anda pilih, jadi pastikan kunci sk_test_ dipasangkan dengan Sandbox dan kunci sk_live_ dengan Produksi.

Apakah saya perlu rahasia penandatanganan webhook?

Webhook adalah cara Stripe memberi tahu aplikasi Anda bahwa “pembayaran ini berhasil”, bahkan jika pelanggan menutup halaman sebelum kembali. Aplikasi yang membuka akses ke sesuatu setelah pembayaran, atau yang menjalankan langganan, sebaiknya memilikinya. Tambahkan setelah aplikasi Anda diterbitkan, karena Stripe tidak dapat menjangkau pratinjau pribadi Anda:

Tanyakan kepada MonstarX: “Apa alamat webhook Stripe saya, dan event apa saja yang harus didengarkannya?” Biasanya alamatnya https://your-app.monstarx.app/api/stripe-webhook.
Di Stripe, buka Webhooks, klik Create an event destination, pilih event tersebut, pilih Webhook endpoint, lalu tempel alamatnya.
Tampilkan signing secret (diawali whsec_) dan salin.
Di MonstarX, klik Perbarui kunci di baris Stripe, tempel di Rahasia penandatanganan webhook, lalu klik Simpan kunci. Terbitkan ulang aplikasi agar aplikasi yang aktif mendapatkannya.

Sandbox dan live mode masing-masing punya webhook dan signing secret sendiri.

Minta MonstarX menggunakannya

Anda mengetik	Yang terjadi
“Biarkan anggota membeli paket 5 kelas seharga $90 dengan Stripe.”	Tombol beli, checkout Stripe untuk jumlah tersebut, dan halaman terima kasih; paket ditambahkan setelah dibayar.
“Tambahkan paket Pro bulanan seharga $12 dengan Stripe, dan halaman untuk melihat paket saya.”	Checkout langganan dan halaman yang menampilkan paket anggota.
“Tambahkan halaman admin yang menampilkan semua pembayaran.”	Halaman daftar pembayaran, lengkap dengan siapa yang membayar, untuk apa, dan kapan.
“Impor produk Stripe saya ke toko.”	MonstarX memerlukan kunci Anda untuk membaca akun Anda, jadi kartunya menampilkan MonstarX memerlukan Stripe untuk melanjutkan, dan MonstarX melanjutkan sendiri setelah Anda menghubungkannya.

Belum punya kunci? Klik Nanti di kartu tersebut. MonstarX tetap membangun seluruh checkout, dan tombolnya menunjukkan bahwa Stripe belum terhubung sampai Anda menambahkan kunci.

Mulai transaksi nyata

Aktifkan akun Stripe Anda, beralihlah ke live mode, lalu salin kunci live.
Di BackendCloud, klik Perbarui kunci di baris Stripe.
Atur Lingkungan ke Produksi (kunci transaksi nyata), tempel kedua kunci live (dan rahasia penandatanganan webhook live, jika Anda memakainya), lalu klik Simpan kunci.
Terbitkan ulang aplikasi Anda. Mulai saat ini, pembayaran bersifat nyata.

Keamanan dan privasi

Kunci Anda disimpan terenkripsi hanya bersama aplikasi ini. Namanya muncul di BackendRahasia; nilainya tidak pernah ditampilkan lagi.
Kunci rahasia dan rahasia penandatanganan webhook hanya dipakai oleh server aplikasi Anda. Kunci publik memang dibuat untuk terlihat di browser, dan itu aman.
Nomor kartu diketik di halaman checkout milik Stripe sendiri. Nomor kartu tidak pernah sampai ke aplikasi Anda atau ke MonstarX.
Hanya pemilik proyek yang dapat menghubungkan, memperbarui, atau memutuskan koneksi Stripe. Putuskan koneksi menghapus kunci dari aplikasi ini; checkout kemudian menunjukkan bahwa Stripe belum terhubung.
Jika sebuah kunci bocor, ganti kunci (roll) di Stripe Dashboard, lalu tempel kunci baru lewat Perbarui kunci.

Perlu diketahui

Satu aplikasi memakai satu lingkungan Stripe dalam satu waktu. Mengembalikan aplikasi yang aktif ke kunci sandbox akan menghentikan pembayaran sungguhan sampai Anda beralih lagi.
Stripe juga menyediakan restricted keys (rk_…) yang hanya memiliki izin yang Anda pilih. Kunci ini dapat dipakai di kolom Kunci rahasia asalkan mengizinkan semua yang dilakukan aplikasi Anda, misalnya membuat sesi checkout.
Pengujian QA menguji alur pembayaran sampai langkah Stripe dan menandainya sebagai memerlukan kunci selama Stripe belum terhubung.

Pertanyaan umum

Apakah MonstarX mengambil bagian dari penjualan saya?

Tidak. Pembayaran langsung masuk ke akun Stripe Anda. Hanya biaya Stripe sendiri yang berlaku.

Bisakah saya mencoba pembayaran tanpa kartu sungguhan?

Bisa. Hubungkan dengan Sandbox (kunci uji) dan bayar dengan kartu uji 4242 4242 4242 4242, tanggal apa pun di masa depan, dan CVC apa pun. Tidak ada uang yang berpindah.

Bagaimana cara beralih dari pembayaran uji ke pembayaran sungguhan?

Klik Perbarui kunci di baris Stripe, atur Lingkungan ke Produksi (kunci transaksi nyata), tempel kunci live Anda, klik Simpan kunci, lalu terbitkan ulang aplikasi.

Mengapa checkout saya menyatakan Stripe belum terhubung?

Kuncinya belum dimasukkan, atau sudah dihapus. Buka Backend → Cloud dan hubungkan Stripe; pratinjau akan dimulai ulang dengan kunci tersebut.

Bisakah saya melihat pembayaran di MonstarX?

Aplikasi Anda menampilkan apa yang dibangun MonstarX untuknya, seperti halaman pesanan. Catatan lengkap setiap pembayaran, pengembalian dana, dan pencairan ada di Stripe Dashboard Anda.

Terkait

Hubungkan layanan ke aplikasi AndaCara kerja konektor aplikasi, kartu, dan tombol Nanti.

Terbitkan aplikasi AndaTayangkan aplikasi Anda agar Stripe dapat menjangkaunya.

TwilioKirim tanda terima atau pengingat lewat SMS ke pelanggan.

Rahasia dan kunci APITempat kunci Anda disimpan.