Jual kembali nomor virtual pribadi via API SMS Activate App: beli dengan harga kami di akun Anda, tambahkan margin, layani klien dari bot atau situs Anda.
Panduan ini untuk Anda yang ingin menawarkan nomor virtual pribadi kepada klien sendiri melalui layanan white-label, bot Telegram, atau situs kecil. Isinya mencakup cara kerja pengaturannya, cara menentukan harga tiap nomor, panggilan API yang Anda perlukan, cara kerja penagihan, dan batas tanggung jawab kami.
Cara kerja penjualan kembali
Anda memegang satu akun di SMS Activate App dan satu kunci API. Anda membeli nomor di akun tersebut melalui API. Bot atau situs Anda lalu menampilkan nomor milik tiap klien beserta kode verifikasi SMS yang masuk ke nomor itu.
Setiap nomor adalah nomor seluler atau nomor lokal asli dari rentang nomor operator, tergantung negaranya. Akun Anda memegang nomor itu selama masa 28 hari. Nomor ini menerima SMS dan panggilan.
Klien Anda adalah klien Anda sendiri. Anda menerima pembayaran mereka, menjawab pertanyaan mereka, dan menetapkan syarat Anda sendiri. Mereka tidak perlu membuat akun di layanan kami. Penjelasan lebih lanjut tentang model ini ada di halaman reseller.
Tentukan harga dan margin Anda
Harga kami ditetapkan per nomor dan per negara. Anda membacanya secara langsung dari API:
- GET /v1/public/countries mengembalikan minPriceCents, maxPriceCents, dan availableNumbers untuk tiap negara.
- GET /v1/public/numbers/search?country=US&limit=20 mengembalikan nomor yang sedang dijual. Kolom priceCents pada tiap nomor adalah harga Anda.
Semua nilai uang di API dinyatakan dalam sen USD berupa bilangan bulat.
Harga jual Anda adalah harga kami untuk nomor tersebut ditambah margin Anda. Jika sebuah nomor Anda beli seharga C dan Anda jual seharga P, margin Anda adalah P dikurangi C. Persentase margin Anda adalah (P dikurangi C) dibagi P. Markup adalah angka yang berbeda: (P dikurangi C) dibagi C. Markup selalu yang lebih besar di antara keduanya, jadi pastikan mana yang Anda maksud sebelum menetapkan target.
Hitung ulang dari harga terkini setiap kali terjadi penjualan. Jangan berpatokan pada daftar harga tetap, karena harga bisa berubah per negara. Tidak ada diskon reseller atau tingkatan harga berdasarkan volume: Anda membeli dengan harga normal, sama seperti yang tercantum di halaman harga.
Anggarkan juga biaya berikut:
- Pembelian bersifat final. Nomor yang sudah diterbitkan bersifat final dan tidak dapat dikembalikan dananya, meskipun sebuah platform menolaknya.
- Keputusan platform. Platform itu sendiri, bukan kami, yang memutuskan apakah sebuah nomor diterima. Biarkan klien Anda memeriksa dulu bahwa nomor berfungsi untuk layanan mereka, atau masukkan risiko tersebut ke dalam harga Anda.
- Perpanjangan otomatis. Nomor diperpanjang dan ditagih setiap 28 hari kecuali Anda mematikan perpanjangan otomatis.
- Biaya pembayaran. Pemroses pembayaran Anda mengenakan biaya untuk setiap pembayaran dari klien.
- Waktu dukungan. Klien Anda akan bertanya kepada Anda, dan menjawabnya menyita waktu Anda.
Alur API, langkah demi langkah
URL dasarnya adalah https://api.sms-activate.app/v1/public. Setiap panggilan, termasuk katalog, memerlukan kunci Anda di header Authorization: Bearer vpn_xxx.
- Tampilkan daftar negara. Panggil GET /countries untuk melihat negara mana yang memiliki nomor beserta rentang harganya.
- Cari nomor. Panggil GET /numbers/search?country=US&limit=20 untuk menampilkan nomor yang tersedia di suatu negara, masing-masing dengan harga Anda di priceCents.
- Beli nomor. Panggil POST /numbers dengan body JSON {"phone": "+15551234567", "country": "US"} dan header Idempotency-Key berisi UUID. Jika Anda mengirim kunci yang sama saat mencoba ulang, Anda tidak ditagih dua kali. Pembelian yang berhasil mengembalikan 201 beserta nomor, chargedCents, dan balanceAfterCents. Ada dua kolom opsional: autoRenew (bawaan true) dan note. Gunakan note untuk menyimpan referensi klien Anda.
- Baca kode. Panggil GET /numbers/{id}/sms untuk satu nomor, atau GET /sms untuk semua nomor Anda. Keduanya menggunakan paginasi berbasis kursor. Agar kode dikirim langsung kepada Anda, panggil PATCH /numbers/{id} dengan {"forwardWebhookUrl": "https://your-app.example.com/sms"}: setelah itu setiap SMS dan telepon masuk ke nomor tersebut dikirim ke server Anda, ditandatangani dengan HMAC-SHA256. Cocokkan setiap kode dengan klien yang tepat sebelum Anda menampilkannya.
- Kelola masa aktif. Jika klien tidak memperpanjang, panggil PATCH /numbers/{id} dengan {"autoRenew": false}. Untuk melepas nomor yang tidak Anda perlukan lagi, panggil DELETE /numbers/{id}.
Dua panggilan lain membantu pembukuan. GET /balance mengembalikan saldo Anda dalam sen. GET /v1/me/transactions menampilkan laporan mutasi Anda.
Galat selalu datang dalam satu bentuk: {"error": "<code>", "message": "...", "reqId": "..."}. Tentukan penanganan berdasarkan kode error, bukan status HTTP. Beberapa penolakan, seperti insufficientbalance, nonumbers, dan priceexceeded, adalah jawaban. Tampilkan kepada klien Anda alih-alih mencoba ulang tanpa pertimbangan. Pada ratelimited, tunggu selama waktu yang disebutkan header Retry-After.
Spesifikasi lengkapnya ada di file OpenAPI, dan dokumentasi API menjelaskan setiap panggilan.
Penagihan: saldo Anda di layanan kami
Pembelian Anda dibayar dari saldo akun Anda. Di situs web, Anda mengisi saldo dengan kripto (USDT). Bot Telegram juga menerima kartu bank dalam rubel dan Telegram Stars. Setelah Anda menautkan akun, keduanya memakai satu saldo yang sama.
Siapkan saldo yang cukup sebelum jam sibuk Anda. Pembelian dengan saldo yang kurang akan ditolak dengan insufficient_balance, dan klien Anda harus menunggu selama Anda mengisi saldo.
Penarikan dana hanya dibayarkan dalam USDT (TRON, BSC, atau TON). Anda menariknya sendiri di akun Anda di situs atau di bot Telegram: hingga $100 per hari dibayar otomatis dalam beberapa menit, dan jumlah yang lebih besar dibayar tim dukungan secara manual atas permintaan. Uang dari pembayaran kartu, bonus, atau transfer yang diterima dapat ditarik 180 hari setelah masuk; isi ulang kripto dapat langsung ditarik. Jumlah minimumnya $10. Biayanya 10% dari jumlah penarikan, tetapi tidak kurang dari 5 USDT, dan dipotong dari jumlah tersebut.
Pembelian Anda sendiri dan program mitra
Pembelian di akun Anda sendiri, atau di akun mana pun yang Anda kendalikan, tidak pernah menghasilkan komisi mitra.
Sebagian klien akan lebih memilih memiliki akun sendiri. Kirimkan tautan mitra Anda kepada mereka. Anda kemudian mendapatkan 10% hingga 30% dari margin kami (bukan dari harga) atas pembelian dan perpanjangan mereka selama akun mereka masih ada; bagiannya naik sesuai jumlah orang yang Anda bawa yang sudah membeli, dari 10% untuk 3 pembeli pertama hingga 30% mulai pembeli ke-3001. Setiap komisi masuk ke saldo Anda 30 hari setelah pembelian. Rinciannya ada di halaman program afiliasi dan reseller.
Dukungan
Klien Anda menghubungi Anda. Anda menghubungi kami. Seorang petugas menjawab melalui email di support@sms-activate.app atau di Telegram di t.me/BestVoipTelegram, biasanya dalam 24 jam.
Jangan menjanjikan kepada klien Anda lebih dari yang kami janjikan kepada Anda. Kami tidak menjanjikan bahwa setiap kode pasti masuk, dan kami tidak menjanjikan bahwa platform akan menerima sebuah nomor. Sebagian besar kode masuk dalam beberapa menit setelah platform mengirimkannya. Minta klien Anda menguji nomor untuk layanan mereka sebelum mengandalkannya.
Video yang bermanfaat
Video dari pihak ketiga tentang penetapan harga, bot Telegram, dan desain API. Video ini mengajarkan teknik umum dan tidak membahas layanan kami.
- Markup vs Margin, they are not the same thing! (Brad Flynn): perbedaan antara markup dan margin, dengan contoh perhitungan.
- The 6 Components of a SaaS Pricing Model (Willingness to Pay): metrik, periode, diskon, dan titik harga dalam sebuah model penetapan harga.
- Aiogram Basics: Build Your First Telegram Bot with Python (Almaz | Coding): konsep bot Telegram dan bot pertama yang berfungsi dengan Python.
- Build a Python Telegram Bot that Accepts Stars Payment (2025) (Nikandr Surkov): menerima pembayaran dengan Telegram Stars di dalam bot Python.
- What is API Idempotency and Why Is It Important? (Be A Better Dev): alasan pembelian yang dicoba ulang tidak boleh menagih dua kali, dan cara kunci idempotensi mencegahnya.
- Polling vs Webhooks | System Design Tradeoffs (SoftwareDude): kapan meminta data baru secara berkala dan kapan data tersebut dikirimkan langsung kepada Anda.
Mulai
- Buat akun gratis di halaman pendaftaran.
- Buat kunci API di dasbor akun, pada tab kunci API.
- Baca dokumentasi API dan file OpenAPI.
- Periksa harga terkini di halaman harga.
- Beli satu nomor dan uji seluruh alur Anda dari awal hingga akhir sebelum membuka penjualan.