Reseller API
The Seru reseller API for Telegram bots, web shops and your own whitelabel panel. Wholesale prices across 7,391+ services, atomic balance with auto-refund, 24/7 automated processing. You keep the margin — seru handles the rest.
Seru API v2 60 requests/min MYR Reseller & Agen only
One endpoint, the whole panel. Everything below is live today.
The API is for Reseller and Agen accounts. Every eligible account gets a key automatically — no separate application, no extra fee on top of your level.
curl -X POST https://app.seru.my/api/v1 \
-d "key=YOUR_API_KEY" -d "action=balance"
→ 200 OK { "balance": "10.00", "currency": "MYR" } From sign-up to your first automated order in four steps.
Sign up as reseller
One-time RM30 payment, RM10 balance instantly. Admin verifies activation (usually a few minutes in business hours).
Copy your API key
Log in → Account → API Key. Every reseller/agen account gets a key automatically.
POST to the endpoint
Send form-encoded key + action to https://app.seru.my/api/v1. Start with services to list catalogue, then add to place an order.
Poll status & automate
Track orders with status, request refill, cancel when allowed. Wire it into your bot or panel and run 24/7.
Endpoint
POST https://app.seru.my/api/v1
Form-encoded (or JSON) body with key and
action. Responses
are flat JSON, Seru API style. Errors return { "error": "..." }.
Real request and response shapes. Replace YOUR_API_KEY with the key from your Account menu.
add · curl
curl -X POST https://app.seru.my/api/v1 \
-d "key=YOUR_API_KEY" \
-d "action=add" \
-d "service=12" \
-d "link=https://tiktok.com/@shop" \
-d "quantity=1000"
→ 200 OK { "order": "8271" } status · curl
curl -X POST https://app.seru.my/api/v1 \
-d "key=YOUR_API_KEY" -d "action=status" -d "order=8271"
→ 200 OK {
"charge": "0.79", "start_count": "1200",
"status": "Completed", "remains": "0", "currency": "MYR"
} telegram bot · python
import requests # pip install requests
API = "https://app.seru.my/api/v1"
KEY = "YOUR_API_KEY"
def place_order(service, link, quantity):
r = requests.post(API, timeout=30, data={
"key": KEY, "action": "add",
"service": service, "link": link, "quantity": quantity,
})
return r.json() # {"order": "8271"}
def order_status(order_id):
r = requests.post(API, timeout=30, data={
"key": KEY, "action": "status", "order": order_id,
})
return r.json() # {"status": "Completed", ...} Fourteen actions in the Seru API. Full parameter tables and per-type fields are in the technical documentation.
| action | parameters | response |
|---|---|---|
| services | — | [{ service, name, type, category, rate, min, max, refill, cancel }] |
| add | service, link, quantity (+ type fields, idempotency_key) | { order } |
| bulk_add | orders (JSON array ≤100) | [{ order } | { error }] |
| status | order | orders (≤100) | { charge, start_count, status, remains, currency } |
| refill | order | orders (≤100) | { refill } | [{ order, refill }] |
| refill_status | refill | refills (≤100) | { status } | [{ refill, status }] |
| cancel | orders (≤100) | [{ order, cancel: 1 | { error } }] |
| balance | — | { balance, currency } |
| orders | status, service, limit (≤100), offset | [{ order, service, name, link, quantity, charge, status, remains, start_count, created_at, currency }] |
| set_webhook | url (https), regenerate_secret | { webhook_url, webhook_secret, enabled } |
| set_api_secret | require_signature | { api_secret, sign_required } |
| deposit | amount (RM) | { invoice, transfer_amount, credited, status, payment_qr } |
| deposits | limit, offset | [{ invoice, amount, status, created, expire }] |
| affiliate | — | { commission, downline, ref_link, can_withdraw } |
Order status
Pending · Processing · In progress · Completed · Partial · Canceled · Error
Units & limits
Currency MYR. Rate per 1,000 (Default) or per pack (Package). 60 req/min per IP · batch ≤100 IDs.
Yes. The Seru API uses the same key + action calls and flat JSON responses (services, add, status, refill, refill_status, cancel, balance) as popular SMM panel APIs, so your existing bots and whitelabel panels work by changing the base URL to app.seru.my/api/v1 and using your Seru key. Currency is MYR.
Reseller and Agen levels only. Member and Admin accounts do not have API access. Every eligible account receives an API key automatically in the Account menu — no separate application.
Sign up as a reseller for a one-time RM30 payment (RM10 balance lands instantly). After admin verifies your activation, your API key appears under Account → API Key. Log in any time to copy it.
Exactly like the panel checkout: your level rate (reseller/agen) plus any category override, billed per 1,000 for Default services and per pack for Package services. The services action returns your live rate, min and max. Your profit is your sell price minus the wholesale cost.
Balance is deducted atomically before the provider is contacted. If the provider rejects the order or is inactive, the full amount is refunded to your balance automatically. Failed orders are refunded — you only manage the relationship with your client.
Yes. Use refill for services labelled refill (warranty period applies), and cancel for services that allow cancellation. Cancellation is provider-safe: the order enters Canceling and the refund is issued after the provider confirms.
60 requests per minute per IP. For batch operations you can pass up to 100 order IDs (comma-separated) in a single status, refill or cancel request.
Yes — the orders action (alias history) lists your orders newest-first, with optional status and service filters plus limit/offset pagination. The full technical reference lives at the API documentation page.
Yes — register a public https URL with the set_webhook action. When an order reaches a final status, Seru POSTs a signed JSON payload (HMAC-SHA256, X-Seru-Signature header) to your URL, with automatic retry backoff. Verify the signature with your webhook_secret. You can also place up to 100 orders at once with bulk_add.
Pass an idempotency_key to the add action. Replaying the same key returns the same order ID without charging again or creating a duplicate order — ideal for bots and network retries. Keys are scoped per account (up to 100 characters); a failed request releases the key so it can be reused.
Yes — official Python, PHP and Node.js clients plus a Telegram bot example wrap every action (including orders history and idempotency keys) with typed helpers and error handling. Python and Node need no third-party dependencies. See the SDK section in the technical documentation.
Yes. Generate an HMAC secret with set_api_secret and the SDKs auto-sign every request (timestamp + HMAC-SHA256 signature, replay-protected); you can make signatures mandatory. For testing, pass sandbox=1 to add/bulk_add/status/balance — orders are simulated (fake SBX- ids, computed charge) with no deduction, no provider call and no database write.
Yes. The deposit action creates a manual DuitNow top-up invoice (pending, credited after admin confirmation — same as the web app), deposits lists history, and affiliate returns your commission/downline/referral stats read-only. A free whitelabel starter panel (single-file Node.js, key kept server-side) is included in the SDK so you can launch your own branded reseller panel quickly.
Yes. seru handles stock, processing, status polling and refill; you brand the front-end and call the API with your key. Your clients see your panel, never the upstream provider.
Sign up as reseller, copy your key, and place your first API order in minutes. Wholesale pricing stays active across all 7,391 services.
By signing up you agree to the Seru Terms of Service.