Sambungkan Stripe ke aplikasi MonstarX anda
RingkasnyaStripe membolehkan aplikasi anda menerima bayaran sebenar. Tampal kunci Stripe anda dalam Backend → Cloud (atau pada kad yang ditunjukkan oleh MonstarX dalam perbualan), dengan memilih Sandbox (kunci ujian) semasa anda mencuba dan Production (kunci sebenar) apabila pelanggan sebenar membayar. MonstarX menulis checkout untuk anda.
Terima bayaran kad, langganan dan checkout dalam aplikasi anda.
- Jenis
- Untuk aplikasi anda
- Kategori
- Pembayaran dan pengebilan
- Sambung melalui
- Kunci API
Stripe ialah syarikat pembayaran: ia menguruskan borang kad, urusan dengan bank dan resit, serta memindahkan wang ke akaun bank anda. Sambungkannya, dan aplikasi anda boleh menjual — pas kelas, produk, keahlian bulanan — dengan halaman checkout selamat yang dikendalikan oleh Stripe.
Apakah yang boleh anda bina dengannya?
Bahagian bertajuk “Apakah yang boleh anda bina dengannya?”- Butang “Beli sekarang” yang membuka halaman checkout Stripe dan membawa pelanggan kembali ke aplikasi anda selepas mereka membayar.
- Pas dan pakej, seperti “5 kelas dengan harga $90”, yang membuka akses kepada sesuatu dalam aplikasi selepas dibayar.
- Langganan bulanan atau tahunan untuk ahli atau pelan berbayar.
- Sejarah pesanan bagi setiap pelanggan, dan halaman admin yang menyenaraikan bayaran.
- Tindakan susulan automatik, seperti menandakan pesanan sebagai dibayar dan menghantar resit melalui e-mel, apabila Stripe mengesahkan bayaran.
Sebelum anda bermula
Bahagian bertajuk “Sebelum anda bermula”- Akaun Stripe. Membuka akaun tidak dikenakan bayaran; Stripe mengenakan yuran bagi setiap bayaran yang berjaya (lihat harga Stripe). MonstarX tidak mengenakan apa-apa caj tambahan.
- Untuk ujian, tiada apa-apa lagi diperlukan: setiap akaun Stripe boleh menggunakan sandbox, salinan latihan akaun anda yang tidak melibatkan wang sebenar.
- Untuk bayaran sebenar, Stripe meminta anda mengaktifkan akaun terlebih dahulu — butiran perniagaan anda dan akaun bank untuk menerima wang.
Apakah Sandbox dan Production?
Bahagian bertajuk “Apakah Sandbox dan Production?”Stripe memberi anda dua set kunci, dan MonstarX bertanya set mana yang anda tampal melalui pilihan Persekitaran:
| Persekitaran | Kunci bermula dengan | Apa yang berlaku |
|---|---|---|
| Sandbox (kunci ujian) | sk_test_… dan pk_test_… | Bayaran olok-olok dengan nombor kad ujian. Tiada kad sebenar dicaj dan tiada wang berpindah. Gunakannya semasa anda membina. |
| Production (kunci sebenar) | sk_live_… dan pk_live_… | Kad sebenar, wang sebenar, dipindahkan ke bank anda. Gunakannya apabila pelanggan sebenar membayar. |
Apa yang anda cipta dalam satu persekitaran tidak wujud dalam yang satu lagi: produk, harga, pelanggan dan bayaran yang dibuat dalam sandbox kekal dalam sandbox.
Bagaimanakah saya membayar dengan kad ujian?
Bahagian bertajuk “Bagaimanakah saya membayar dengan kad ujian?”Dalam sandbox, checkout Stripe menerima kad ujian yang diterbitkannya. Gunakan mana-mana tarikh luput pada masa hadapan (seperti 12/34), mana-mana CVC tiga digit dan mana-mana poskod:
| Nombor kad | Apa yang berlaku |
|---|---|
4242 4242 4242 4242 | Bayaran berjaya. |
4000 0000 0000 0002 | Kad ditolak, jadi anda boleh melihat apa yang dilihat oleh pelanggan apabila bayaran gagal. |
4000 0025 0000 3155 | Bank meminta semakan tambahan (3D Secure) sebelum bayaran diproses. |
Jangan sekali-kali menaip nombor kad sebenar dalam checkout sandbox. Stripe menyenaraikan lebih banyak kad ujian dalam panduan ujiannya.
Dapatkan kunci anda
Bahagian bertajuk “Dapatkan kunci anda”-
Log masuk ke Stripe Dashboard.
-
Untuk menguji, buka sandbox daripada menu akaun di bahagian atas sebelah kiri. Untuk bayaran sebenar, tukar kepada live mode.
-
Buka API keys (di bawah Developers). Salin Publishable key, kemudian paparkan dan salin Secret key.
Sambungkannya dalam MonstarX
Bahagian bertajuk “Sambungkannya dalam MonstarX”Apabila anda meminta ciri bayaran, MonstarX biasanya menunjukkan kad Sambungkan Stripe dalam perbualan dengan medan yang sama. Anda juga boleh menyambungkannya sendiri:
-
Buka projek anda dan klik Backend di bar atas, kemudian Cloud.
-
Di bawah Penyambung, klik Sambungkan di sebelah Stripe.
-
Pilih Persekitaran: Sandbox (kunci ujian) atau Production (kunci sebenar).
-
Tampal Kunci rahsia dan Kunci awam. Biarkan Rahsia tandatangan webhook kosong buat masa ini.
-
Klik Sambungkan Stripe. Baris itu menunjukkan Disambungkan · sandbox (atau Disambungkan · production) dan pratonton anda dimulakan semula dengan kunci itu.
MonstarX tidak menyemak sama ada kunci sepadan dengan persekitaran yang anda pilih, jadi pastikan kunci sk_test_ dipadankan dengan Sandbox dan kunci sk_live_ dengan Production.
Perlukah saya menggunakan rahsia tandatangan webhook?
Bahagian bertajuk “Perlukah saya menggunakan rahsia tandatangan webhook?”Webhook ialah cara Stripe memberitahu aplikasi anda “bayaran ini berjaya”, walaupun pelanggan menutup halaman sebelum kembali. Aplikasi yang membuka akses kepada sesuatu selepas bayaran, atau menjalankan langganan, patut mempunyainya. Tambahkannya selepas aplikasi anda diterbitkan, kerana Stripe tidak dapat mencapai pratonton persendirian anda:
-
Tanya MonstarX: “Apakah alamat webhook Stripe saya, dan peristiwa apa yang patut didengarnya?” Biasanya alamatnya ialah
https://your-app.monstarx.app/api/stripe-webhook. -
Dalam Stripe, buka Webhooks, klik Create an event destination, pilih peristiwa itu, pilih Webhook endpoint dan tampal alamat tersebut.
-
Paparkan signing secret (ia bermula dengan
whsec_) dan salinnya. -
Dalam MonstarX, klik Kemas kini kunci pada baris Stripe, tampalkannya ke dalam Rahsia tandatangan webhook dan klik Simpan kunci. Terbitkan semula supaya aplikasi yang sedang berjalan menerimanya.
Sandbox dan live mode masing-masing mempunyai webhook dan signing secret sendiri.
Minta MonstarX menggunakannya
Bahagian bertajuk “Minta MonstarX menggunakannya”| Anda taip | Apa yang berlaku |
|---|---|
| “Benarkan ahli membeli pas 5 kelas dengan harga $90 melalui Stripe.” | Butang beli, checkout Stripe untuk jumlah itu dan halaman terima kasih; pas ditambah selepas dibayar. |
| “Tambah pelan Pro bulanan pada harga $12 dengan Stripe, dan halaman untuk melihat pelan saya.” | Checkout langganan dan halaman yang menunjukkan pelan ahli. |
| “Tambah halaman admin yang menyenaraikan setiap bayaran.” | Halaman yang menyenaraikan bayaran, dengan siapa yang membayar, untuk apa dan bila. |
| “Import produk Stripe saya ke dalam kedai.” | MonstarX memerlukan kunci anda untuk membaca akaun anda, jadi kad itu menyatakan MonstarX memerlukan Stripe untuk meneruskan dan ia meneruskan kerja dengan sendirinya sebaik sahaja anda menyambung. |
Belum ada kunci? Klik Kemudian pada kad itu. MonstarX tetap membina keseluruhan checkout, dan butangnya menyatakan Stripe belum disambungkan sehingga anda menambah kunci.
Mula menerima bayaran sebenar
Bahagian bertajuk “Mula menerima bayaran sebenar”-
Aktifkan akaun Stripe anda, tukar kepada live mode dan salin kunci live.
-
Dalam BackendCloud, klik Kemas kini kunci pada baris Stripe.
-
Tetapkan Persekitaran kepada Production (kunci sebenar), tampal kedua-dua kunci live (dan rahsia tandatangan webhook live, jika anda menggunakannya) dan klik Simpan kunci.
-
Terbitkan semula aplikasi anda. Mulai saat itu, setiap bayaran ialah bayaran sebenar.
Keselamatan dan privasi
Bahagian bertajuk “Keselamatan dan privasi”- Kunci anda disimpan secara tersulit dengan aplikasi ini sahaja. Namanya muncul dalam BackendRahsia; nilainya tidak akan ditunjukkan lagi.
- Kunci rahsia dan rahsia tandatangan webhook hanya digunakan oleh pelayan aplikasi anda. Kunci awam memang dibuat untuk dilihat dalam pelayar, dan itu selamat.
- Nombor kad ditaip dalam halaman checkout Stripe sendiri. Nombor itu tidak sekali-kali sampai kepada aplikasi anda atau MonstarX.
- Hanya pemilik projek boleh menyambungkan, mengemas kini atau memutuskan sambungan Stripe. Putuskan sambungan mengalih keluar kunci daripada aplikasi ini; checkout kemudian menunjukkan bahawa Stripe tidak disambungkan.
- Jika kunci terbocor, tukar kunci itu (roll) dalam Stripe Dashboard dan tampal kunci baharu dengan Kemas kini kunci.
Perlu diketahui
Bahagian bertajuk “Perlu diketahui”- Satu aplikasi menggunakan satu persekitaran Stripe pada satu-satu masa. Menukar aplikasi yang sedang berjalan kembali kepada kunci sandbox menghentikan bayaran sebenar sehingga anda menukarnya semula.
- Stripe juga menawarkan restricted keys (
rk_…) dengan kebenaran yang anda pilih sahaja. Kunci ini boleh digunakan dalam medan Kunci rahsia jika ia membenarkan semua yang dilakukan oleh aplikasi anda, seperti mencipta sesi checkout. - Ujian QA menguji aliran bayaran sehingga langkah Stripe dan menandakannya sebagai memerlukan kunci selagi Stripe belum disambungkan.
Soalan lazim
Bahagian bertajuk “Soalan lazim”Adakah MonstarX mengambil bahagian daripada jualan saya?
Tidak. Bayaran terus masuk ke akaun Stripe anda. Hanya yuran Stripe sendiri dikenakan.
Bolehkah saya mencuba bayaran tanpa kad sebenar?
Boleh. Sambungkan dengan Sandbox (kunci ujian) dan bayar dengan kad ujian 4242 4242 4242 4242, mana-mana tarikh pada masa hadapan dan mana-mana CVC. Tiada wang berpindah.
Bagaimanakah saya bertukar daripada bayaran ujian kepada bayaran sebenar?
Klik Kemas kini kunci pada baris Stripe, tetapkan Persekitaran kepada Production (kunci sebenar), tampal kunci live anda, klik Simpan kunci dan terbitkan semula.
Mengapakah checkout saya menyatakan Stripe tidak disambungkan?
Kunci belum dimasukkan, atau telah dialih keluar. Buka Backend → Cloud dan sambungkan Stripe; pratonton dimulakan semula dengan kunci itu.
Bolehkah saya melihat bayaran dalam MonstarX?
Aplikasi anda menunjukkan apa yang dibina oleh MonstarX untuknya, seperti halaman pesanan. Rekod penuh setiap bayaran, bayaran balik dan pemindahan wang ada dalam Stripe Dashboard anda.