Reseller API

Order akun GSuite & Hotmail/Outlook otomatis, bayar pakai saldo reseller.

Mulai

Autentikasi

Semua endpoint kecuali /ping, /products, /domains wajib pakai API key:

X-API-Key: mmpgsuite_xxxxxxxxxxxxxxxxxxxx
# atau
Authorization: Bearer mmpgsuite_xxxxxxxxxxxxxxxxxxxx

Batas 60 request/menit per key. Header respons: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. Lewat batas → 429 rate_limited + Retry-After.

Format respons selalu:

{ "success": true,  "data": { ... } }
{ "success": false, "error": { "code": "...", "message": "..." } }

Endpoint

Cek koneksi.

Daftar produk, harga per akun, stok, dan aturan jumlah.

{ "success": true, "data": { "products": [
  { "id": "regular_1d", "name": "GSuite Regular 1 Hari", "duration_days": 1,
    "price_per_account": 150, "min_quantity": 10, "max_quantity": 1000, "quantity_step": 10,
    "stock": 2400, "available": true, "extendable": false },
  { "id": "youtube_b_35d", "name": "GSuite YouTube B 35 Hari", "duration_days": 35,
    "price_per_account": 2000, "min_quantity": 1, "max_quantity": 500,
    "stock": 812, "available": true, "daily_limit": 20 },
  { "id": "hotmail", "name": "Hotmail/Outlook", "price_per_account": 1000,
    "price_tiers": [ {"min_quantity": 10, "price_per_account": 1000}, {"min_quantity": 50, "price_per_account": 900} ],
    "min_quantity": 10, "stock": 530, "available": true,
    "format": "email:password:refresh_token:client_id" }
] } }

Domain yang bisa dipilih per produk. Opsional ?product=regular_1d.

{ "success": true, "data": { "domains": ["..."], "by_product": { "regular_1d": ["..."], "youtube_b_35d": ["..."] } } }

Profil reseller: saldo, password & gaya email default.

Saldo + mutasi terakhir (topup, spend, refund, adjust).

Buat order. Lihat detail di bawah.

Riwayat order (tanpa daftar akun).

Detail order lengkap dengan daftar akun. Pakai ini kalau koneksi putus saat order berjalan.

Buat order

Field	Tipe	Keterangan
product	string	Wajib. regular_1d, youtube_b_35d, atau hotmail. (Kompatibel gaya lama: cukup duration_days 1 / 35.)
quantity	number	Wajib. Regular: kelipatan 10 (10–1000). YouTube B: 1–500. Hotmail: ≥ minimal tier.
domain	string	Opsional (GSuite). Dari /domains. Kosong = dipilih otomatis.
password	string	Opsional (GSuite). 8–100 karakter tanpa spasi. Kosong = password default akunmu, atau acak.
email_style	string	Opsional (GSuite). berurut / acak.
idempotency_key	string	Opsional, sangat disarankan. Key yang sama = order yang sama, aman di-retry, tidak pernah dobel potong saldo.

Sinkron. Request menunggu sampai akun jadi. Set timeout klien minimal 300 detik. Saldo dipotong di awal; akun yang gagal dibuat otomatis direfund ke saldo reseller.

HTTP 201
{ "success": true, "data": {
  "trx_id": "RS-M1ABCD2-XY9ZQ", "status": "success",
  "product": "regular_1d", "duration_days": 1, "quantity": 10,
  "accounts_created": 12, "bonus_accounts": 2, "accounts_failed": 0,
  "price_per_account": 150, "charged": 1500, "refunded": 0, "balance": 48500,
  "domain": "contoh.com", "password": "RahasiaPelanggan1", "email_style": "berurut",
  "expires_at": "2026-10-08T03:11:20+00:00",
  "accounts": ["[email protected]", "[email protected]", "..."] } }

status: success (semua jadi), partial (sebagian jadi, sisanya direfund), failed (respons 502, saldo kembali penuh). 202 = order dengan idempotency_key itu masih diproses — cek lagi lewat GET /orders/{trx_id}.

Hotmail: accounts berisi baris lengkap email:password:refresh_token:client_id.

YouTube B: limit 20 akun/hari (reset 00:00 WIB) sampai total belanjamu Rp500.000, setelah itu bebas limit.

Kode error

HTTP	code	Arti
401	missing_api_key	Header API key tidak ada.
401	invalid_api_key	Key salah / sudah diganti.
403	account_inactive	Akun reseller belum aktif / dinonaktifkan.
402	insufficient_balance	Saldo kurang. Ada field required & balance. Saldo tidak dipotong.
409	out_of_stock	Stok kurang / habis. Ada field available. Saldo tidak dipotong.
503	product_unavailable	Produk sedang maintenance / gangguan. Saldo tidak dipotong.
422	daily_limit	Melebihi limit harian YouTube B. Ada field remaining.
422	validation_error	Parameter salah. Ada field field.
404	not_found	Order / endpoint tidak ada.
429	rate_limited	Lebih dari 60 request/menit. Lihat Retry-After.
502	order_failed	Order gagal total, saldo sudah dikembalikan penuh.

Catatan integrasi

Alur yang disarankan

1. Pembeli order di bot/web kamu → kamu terima pembayaran dari pembeli.
2. (opsional) GET /products  → cek stok & harga terbaru.
3. POST /orders dengan idempotency_key unik per pesanan pembeli (mis. ID pesanan di sistemmu).
4. 201 → kirim data.accounts + password ke pembeli. Simpan trx_id.
   502 → order gagal, saldo sudah balik penuh. Tawarkan ulang / refund pembeli.
   402 / 409 / 503 → saldo/stok/produk bermasalah, saldo TIDAK terpotong.

Timeout & retry (penting)

• Order bersifat sinkron: Regular biasanya beberapa detik, YouTube B bisa 1–4 menit untuk jumlah besar. Pakai timeout klien minimal 300 detik.
• Kalau koneksi putus / timeout, jangan bikin key baru. Kirim ulang POST /orders dengan idempotency_key yang sama, atau cek GET /orders/{trx_id}. Key yang sama tidak pernah memotong saldo dua kali.
• Respons 202 = order dengan key itu masih diproses. Tunggu 10–30 detik lalu ulangi request yang sama.
• Order tetap diproses sampai selesai walau koneksimu putus. Akun yang sudah jadi selalu bisa diambil lagi lewat GET /orders/{trx_id}.

Saldo & refund

• Saldo dipotong saat order dibuat (harga × quantity), sesuai harga di /products saat itu.
• Gagal total → refund penuh otomatis. Gagal sebagian (status: partial) → hanya akun yang tidak jadi yang direfund. Field refunded dan charged menunjukkan angka akhirnya.
• Cek saldo sebelum order lewat GET /account supaya bisa menolak pembeli lebih awal kalau saldo menipis.
• Topup saldo hanya lewat portal (QRIS). Tidak ada endpoint topup.

Produk

• Regular 1 Hari: quantity kelipatan 10. Kadang dapat akun bonus (lihat bonus_accounts) — akun bonus gratis, boleh kamu berikan ke pembeli. Akun aktif 1 hari dan tidak bisa diperpanjang.
• YouTube B 35 Hari: limit 20 akun/hari sampai total belanjamu Rp500.000 (error daily_limit + field remaining). Masa aktif dilihat di expires_at (UTC).
• Hotmail/Outlook: tiap baris email:password:refresh_token:client_id. Garansi hanya jika akun tidak bisa login; refresh token / client_id rusak tidak bergaransi.
• Domain: kalau domain pilihanmu sedang penuh, akun bisa dibuat di domain lain — selalu pakai domain dari isi accounts, bukan dari request.
• Password: kalau tidak diisi dipakai password default akunmu (atur di portal) atau dibuat acak. Selalu pakai field password dari respons.

Keamanan & lain-lain

• Simpan API key di server (env / config), jangan taruh di aplikasi/web sisi pembeli.
• Key bocor? Ganti di portal → tab API. Key lama langsung mati.
• Semua waktu (created_at, expires_at) dalam UTC. WIB = UTC+7.
• Batas 60 request/menit per key. Jangan polling /products tiap detik — cukup sesekali atau sebelum order.
• Struk + file akun tiap order juga dikirim otomatis ke Telegram kamu sebagai cadangan.

Contoh

cURL

curl -X POST https://apimmprojectgsuite.my.id/api/v1/orders \
  -H "X-API-Key: mmpgsuite_xxx" -H "Content-Type: application/json" \
  --max-time 300 \
  -d '{"product":"regular_1d","quantity":20,"password":"PassKuat123","email_style":"berurut","idempotency_key":"order-0001"}'

Python

import requests
r = requests.post(
    "https://apimmprojectgsuite.my.id/api/v1/orders",
    headers={"X-API-Key": "mmpgsuite_xxx"},
    json={"product": "youtube_b_35d", "quantity": 5, "idempotency_key": "order-0002"},
    timeout=300,
)
print(r.status_code, r.json())

Node.js

const r = await fetch("https://apimmprojectgsuite.my.id/api/v1/orders", {
  method: "POST",
  headers: { "X-API-Key": "mmpgsuite_xxx", "Content-Type": "application/json" },
  body: JSON.stringify({ product: "hotmail", quantity: 10, idempotency_key: "order-0003" }),
  signal: AbortSignal.timeout(300000),
});
console.log(await r.json());