Kredensial & Autentikasi
Semua request API memerlukan parameter reseller_key yang disematkan ke dalam request payload untuk autentikasi keamanan. Hubungi Admin SirkelHub untuk mendapatkan key Anda.
Kategori Produk yang Tersedia
Kami menyalurkan transaksi Anda langsung ke vendor terpercaya secara otomatis:
| Kategori | Deskripsi Layanan | Mendukung Top-Up Game / DM |
|---|---|---|
pulsa | Pulsa reguler untuk seluruh operator (Telkomsel, Indosat, XL, Axis, Tri, Smartfren) | ❌ Tidak |
data | Paket kuota internet prabayar | ❌ Tidak |
pln | Token listrik PLN Prabayar | ❌ Tidak |
game | Diamond Game & Voucher: Mobile Legends (ML), Free Fire (FF), PUBG Mobile (PU), Garena Shell (GR) | ✅ Ya (Proses Instan) |
Mengambil daftar seluruh produk beserta kode varian, harga modal, kategori, dan status keaktifan.
Query Parameters
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
category_slug | String | Tidak | Filter berdasarkan kategori (e.g. pulsa, data, pln, game) |
Response Sukses (JSON)
{
"success": true,
"products": [
{
"product_code": "TELKOMSEL_PROMO",
"variant_code": "t5000",
"name": "Telkomsel Rp 5.000",
"price": 5750,
"category": "pulsa",
"status": "normal"
},
{
"product_code": "MOBILE_LEGENDS",
"variant_code": "ml_86",
"name": "Mobile Legends 86 Diamonds",
"price": 19600,
"category": "game",
"status": "normal"
}
]
}Menginisiasi transaksi baru. Endpoint ini akan mengembalikan link atau data gambar QRIS untuk discan oleh pembeli.
Request Body (JSON)
| Field | Tipe | Wajib | Keterangan |
|---|---|---|---|
reseller_key | String | Ya | API Key Anda |
whatsapp_id | String | Ya | Nomor WA pembeli untuk notifikasi (e.g. 081234567890) |
product_code | String | Ya | Kode kategori produk (e.g. MOBILE_LEGENDS / TELKOMSEL_PROMO) |
variant_code | String | Ya | Kode varian produk (e.g. ml_86 / t5000) |
target | String | Ya | Nomor HP Tujuan / ID Game Pelanggan. Untuk Game ML: IDUser(ZoneID), contoh 12345678(1234) |
amount | Number | Ya | Nominal harga yang sesuai dengan pricelist |
Response Sukses (JSON)
{
"success": true,
"transaction_id": "TRX-PP-992138",
"qr_image_url": "https://api.qrserver.com/v1/create-qr-code/?size=300&data=...",
"amount": 19800,
"provider": "portalpulsa"
}Mengambil status pembayaran QRIS dan status fulfillment dari transaksi Anda secara real-time.
Response Status (JSON)
{
"success": true,
"status": "paid",
"message": "Fulfillment sukses dikirim ke nomor tujuan",
"sn": "SN-99823102381203",
"amount": 19800
}Contoh Implementasi Kode
Menggunakan cURL
curl -X POST https://easymall.ilhampradani.me/api/checkout \
-H "Content-Type: application/json" \
-d '{
"reseller_key": "DEMO_RESELLER_KEY_X987HSD23",
"whatsapp_id": "081234567890",
"product_code": "TELKOMSEL_PROMO",
"variant_code": "t5000",
"target": "081299002233",
"amount": 5750
}'Menggunakan Python
import requests
url = "https://easymall.ilhampradani.me/api/checkout"
payload = {
"reseller_key": "DEMO_RESELLER_KEY_X987HSD23",
"whatsapp_id": "081234567890",
"product_code": "TELKOMSEL_PROMO",
"variant_code": "t5000",
"target": "081299002233",
"amount": 5750
}
response = requests.post(url, json=payload)
print(response.json())
