Reseller API

Plug your bot into seru.my. Order, status, refill — one 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

Why build on the seru API.

One endpoint, the whole panel. Everything below is live today.

Wholesale pricing
Order at your reseller/agen rate across all 7,391 services — the same live price you see in the panel. You set the margin, seru handles the cost.
Drop-in compatible
The Seru API uses the familiar key + action calls and flat JSON responses your bot already knows. Point it at the Seru base URL with your key — no rewrite.
Full whitelabel
Your brand on the front, seru under the hood. Stock, processing, status polling and refill are handled for you — your clients never see the upstream provider.
Automate 24/7
Place orders, check status, request refills and cancel — all via endpoints. Wire it into a Telegram bot, a web shop, or your own panel and let it run.
Safe balance handling
Balance is deducted atomically before the provider is contacted. If the provider rejects an order or is inactive, you get a full automatic refund.
Every service type
Default, Package, Custom Comments, Mentions, Poll, Invites, Subscriptions and SEO — type-specific parameters are forwarded exactly like the web checkout.

Who can use it.

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.

  • ✓ Reseller — RM30 one-time, RM10 balance instantly, API key in Account menu.
  • ✓ Agen — best pricing for regular bulk orders, level up from account activity.
  • ✕ Member / Admin — no API access. Upgrade to reseller to unlock it.

How to use it.

From sign-up to your first automated order in four steps.

  1. 01

    Sign up as reseller

    One-time RM30 payment, RM10 balance instantly. Admin verifies activation (usually a few minutes in business hours).

  2. 02

    Copy your API key

    Log in → Account → API Key. Every reseller/agen account gets a key automatically.

  3. 03

    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.

  4. 04

    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": "..." }.

Copy, paste, order.

Real request and response shapes. Replace YOUR_API_KEY with the key from your Account menu.

Action reference.

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.

API questions, answered.

Is the API compatible with other SMM panels?

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.

Who can use the API?

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.

How do I get an API key?

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.

How is the price calculated?

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.

What happens if an order fails?

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.

Can I refill or cancel orders via the API?

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.

What is the rate limit?

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.

Is there an order-history endpoint?

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.

Can I get webhook callbacks instead of polling?

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.

How do I avoid duplicate orders when retrying?

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.

Is there an SDK?

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.

Can I sign requests and test without spending balance?

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.

Can I top up balance and run my own branded panel?

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.

Can I run my own whitelabel panel on top of it?

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.

Your bot can order tonight.

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.