Gunakan Paddle dengan MonstarX
SingkatnyaPilih Sandbox atau Produksi (live), lalu tempel kunci API Paddle di baris Paddle di Backend → Cloud. Setelah itu, MonstarX dapat membaca produk, pelanggan, transaksi, dan langganan Paddle Anda, misalnya untuk membangun halaman harga yang sesuai dengan katalog Anda. MonstarX hanya membaca: tidak pernah mengubah apa pun di Paddle.
Lihat produk, pelanggan, dan langganan.
- Jenis
- Alat bisnis · kunci API
- Kategori
- Pembayaran dan penagihan
- Hubungkan dengan
- Kunci API
Paddle menjual perangkat lunak dan produk digital untuk Anda serta mengurus penagihan, pajak, dan langganan. Hubungkan akun Paddle Anda dengan kunci API (kode mirip kata sandi yang mengizinkan perangkat lunak memakai akun Anda), dan pembuat aplikasi MonstarX — AI yang Anda ajak bercakap — dapat membaca katalog dan data penagihan Anda saat bekerja: membangun halaman harga dari produk Anda yang sebenarnya, atau merangkum paket apa saja yang dipakai pelanggan Anda.
Ini adalah alat bisnis: MonstarX membaca Paddle atas nama Anda. Aplikasi yang Anda bangun tidak pernah menerima kunci Anda. Untuk menerima pembayaran di aplikasi Anda, lihat Stripe.
Apa yang bisa dilakukan MonstarX?
Section titled “Apa yang bisa dilakukan MonstarX?”| Yang bisa dilakukan MonstarX | Kapan |
|---|---|
| Menampilkan daftar produk Anda | Semua mode |
| Menampilkan daftar pelanggan Anda | Semua mode |
| Menampilkan daftar transaksi Anda | Semua mode |
| Menampilkan daftar langganan Anda | Semua mode |
Setiap daftar muncul 20 item sekaligus (hingga 30), dan MonstarX dapat membuka halaman berikutnya untuk melihat lebih banyak. Yang tidak pernah dilakukannya: membuat, mengubah, atau membatalkan apa pun — produk, harga, pelanggan, transaksi, langganan, maupun pengembalian dana.
Sebelum memulai
Section titled “Sebelum memulai”- Akun Paddle. Akun sandbox berisi data uji; akun live berisi data sungguhan. Keduanya adalah akun terpisah dengan kunci yang terpisah.
- Anda adalah pemilik proyek MonstarX. Hanya pemilik yang dapat menghubungkan atau memutuskan koneksi alat.
Dapatkan kunci Anda
Section titled “Dapatkan kunci Anda”-
Di Paddle (sandbox atau live, mana saja yang ingin Anda hubungkan), buka Developer Tools > Authentication, lalu buka tab API keys.
-
Klik New API key dan beri nama, misalnya
MonstarX. -
Berikan izin baca berikut:
product.read,customer.read,transaction.read, dansubscription.read. MonstarX tidak memerlukan izin lain dan tidak pernah memakai izin tulis. -
Tetapkan tanggal kedaluwarsa (bawaan Paddle 90 hari), simpan, lalu salin kuncinya. Kunci diawali
pdl_sdbx_apikey_untuk sandbox ataupdl_live_apikey_untuk live.
Panduan dari Paddle: Create and manage API keys.
Hubungkan di MonstarX
Section titled “Hubungkan di MonstarX”-
Buka proyek Anda, klik Backend di bilah atas, lalu Cloud.
-
Gulir ke Konektor, cari Paddle, lalu klik Hubungkan.
-
Pilih Sandbox atau Produksi (live) sesuai kunci Anda, tempel kunci di kolom kunci, lalu klik Hubungkan.
-
MonstarX memeriksa kunci ke Paddle. Jika berhasil, baris tersebut menampilkan Terhubung ke Sandbox atau Terhubung ke Produksi. Jika kunci dan lingkungannya tidak cocok, Paddle menolaknya dan tidak ada yang disimpan.
Minta MonstarX menggunakannya
Section titled “Minta MonstarX menggunakannya”| Anda mengetik | Yang terjadi |
|---|---|
| “Baca produk Paddle saya dan buat halaman harga dengan paket dan nama yang sama.” | MonstarX menampilkan produk Anda dan, di mode Bangun, membuat halaman dari produk tersebut. |
| “Berapa banyak langganan aktif saya di Paddle, dan di paket apa saja?” | MonstarX menelusuri halaman demi halaman langganan Anda dan merangkumnya di percakapan. |
| “Lihat 20 transaksi Paddle terakhir saya dan beri tahu produk mana yang paling laris.” | MonstarX membaca transaksi tersebut dan menjawab. |
Keamanan dan privasi
Section titled “Keamanan dan privasi”- Tetap di MonstarX. Kunci disimpan terenkripsi di server MonstarX. Kunci tidak pernah ditulis ke kode aplikasi atau diberikan ke aplikasi Anda.
- Hanya baca. MonstarX hanya meminta daftar dari Paddle. Beri kunci izin baca saja, sehingga kunci yang bocor pun tidak dapat mengubah penagihan Anda.
- Data konfidensial. Detail pelanggan dan penagihan diperlakukan sebagai data pribadi dan sebagai informasi, tidak pernah sebagai instruksi.
- Putuskan koneksi kapan saja. Klik Putuskan koneksi di samping Paddle di BackendCloud, lalu konfirmasi Putuskan koneksi Paddle dari proyek ini?. MonstarX menghapus kunci tersebut. Cabut juga kuncinya di Paddle jika tidak diperlukan lagi.
Perlu diketahui
Section titled “Perlu diketahui”- Mulailah dengan Sandbox selama membangun, lalu beralih: putuskan koneksi dan hubungkan lagi dengan kunci live.
- Saat kunci kedaluwarsa di Paddle, permintaan MonstarX akan gagal. Buat kunci baru lalu hubungkan lagi.
- Satu proyek hanya dapat terhubung ke satu akun Paddle dalam satu waktu.
Pertanyaan umum
Section titled “Pertanyaan umum”Bisakah aplikasi saya menerima pembayaran lewat Paddle dengan ini?
Tidak. Koneksi ini memungkinkan MonstarX membaca data Paddle Anda. Untuk pembayaran di aplikasi Anda, MonstarX punya konektor Stripe. Untuk penyedia lain, tambahkan kuncinya di Backend → Rahasia dan minta MonstarX membangunnya.
Izin apa saja yang diperlukan kunci?
product.read, customer.read, transaction.read, dan subscription.read. Hilangkan izin untuk data yang tidak ingin dibaca MonstarX — daftar tersebut hanya akan gagal dimuat.
Bisakah MonstarX melakukan pengembalian dana atau membatalkan langganan?
Tidak. MonstarX hanya dapat menampilkan daftar produk, pelanggan, transaksi, dan langganan.
Mengapa kunci saya ditolak?
Biasanya karena kunci tersebut untuk lingkungan yang lain: kunci pdl_sdbx_ memerlukan Sandbox, kunci pdl_live_ memerlukan Produksi. Kunci yang kedaluwarsa atau sudah dicabut juga ditolak.