API Reference chevron_right Order Process Types

settings CONCEPTS

Order Process Types

Memahami jenis-jenis proses order yang tersedia dan cara menangani response masing-masing tipe.

info Overview

Setiap item/variant memiliki order_process yang menentukan bagaimana pesanan diproses dan data apa yang akan dikembalikan.

Type	Description	Response Data
auto	Produk digital dengan stok (akun, lisensi, voucher)	product_license, note
manual	Produk yang diproses manual oleh admin	note (diisi setelah diproses)
h2h	Host-to-Host (Pulsa, Token PLN, PPOB)	h2h_results (sn, status)
smm	Social Media Marketing (followers, likes, views)	smm_results (order_id, status, remains)

bolt Auto Process

Instant Delivery

Produk dengan stok yang sudah tersedia di sistem. Data produk (akun/lisensi) akan langsung dikirimkan setelah pembayaran berhasil.

Contoh Produk:

Akun Premium (Netflix, Spotify, Canva, dll)
Lisensi Software
Voucher Game
Gift Card

Response Fields:

product_license string|null

Data akun/lisensi yang dikirimkan. Format tergantung produk (email|password, kode voucher, dll)

note string|null

Catatan tambahan dari seller (cara pakai, expired date, dll)

person Manual Process

Admin Processed

Produk yang memerlukan proses manual oleh admin. Status akan berubah setelah admin memproses pesanan dan mengisi data.

Contoh Produk:

Jasa Desain
Custom Order
Produk yang perlu verifikasi
Akun Premium yang dibuat manual

Status Flow:

pending arrow_forward sent arrow_forward completed

Response Fields:

note string|null

Catatan order dari customer (misal: link akun, username, dll)

licenses array|null

Data/lisensi yang dikirimkan oleh admin (tersedia setelah status sent)

webhook

Webhook Event: order.item.sent

New

Untuk produk manual, webhook order.item.sent akan dikirim secara real-time ketika admin mengirimkan pesanan. Anda tidak perlu polling status berkala.

Payload Example:

{
  "event": "order.item.sent",
  "timestamp": "2026-02-12T00:24:15+07:00",
  "data": {
    "invoice": "SPY1770830637OC8V",
    "ref_id": "INV-20260212-NQGYFI",
    "transaction_status": "paid",
    "item": {
      "order_item_id": "01kh6vpatp6yhphh181zz3a8qv",
      "variant_id": 9,
      "variant_name": "Ios 1 Bulan",
      "product_name": "Apple Music",
      "order_process": "manual",
      "quantity": 1,
      "price": 3325,
      "status": "sent",
      "note": "https://t.me/sekalipaych/4",
      "licenses": [
        {
          "product_license": "[email protected]|password123",
          "note": null
        }
      ],
      "sent_at": "2026-02-12T00:24:15+07:00"
    }
  }
}

tips_and_updates

Tips: Handle event ini untuk langsung menampilkan data ke customer tanpa menunggu status completed.

ℹ️ Backward Compatible

Event order.item.sent bersifat opsional. Jika Anda tidak menghandle event ini, sistem tetap akan mengirim order.completed seperti biasa. Integrasi yang sudah ada tetap berfungsi normal.

sync_alt H2H Process (Host-to-Host)

Auto via Provider API

Produk yang diproses otomatis melalui API provider (DigiFlazz, Tripay, dll). Biasanya untuk produk PPOB seperti pulsa, token listrik, paket data.

Contoh Produk:

Pulsa All Operator
Token Listrik PLN
Paket Data Internet
Voucher Game (Diamond ML, UC PUBG, dll)
E-Wallet (OVO, DANA, GoPay)

Response Fields (h2h_results):

variant_id integer

ID variant yang diproses

sn string

Serial Number dari provider. Untuk token PLN berisi kode token 20 digit.

dispatch_status string

Status dispatch: completed atau failed

log_message string

Pesan dari provider (opsional)

⚠️ Handling Failed Transactions

Jika dispatch_status: "failed", field sn akan berisi pesan error seperti: "failed: Nomor tidak valid". Saldo akan otomatis dikembalikan.

thumb_up SMM Process (Social Media Marketing)

Auto via SMM Panel

Produk SMM yang diproses melalui panel SMM. Proses berjalan bertahap dan status dapat dipantau melalui API.

Contoh Produk:

Instagram Followers, Likes, Views
TikTok Followers, Views, Likes
YouTube Subscribers, Views, Likes
Twitter/X Followers
Facebook Page Likes

Response Fields (smm_results):

variant_id integer

ID variant yang diproses

order_id string|null

ID order dari SMM Panel

status string

Status order: Pending, In progress, Completed, Partial, Canceled

start_count integer|null

Jumlah awal sebelum order diproses

remains integer|null

Sisa yang belum diproses. Jika 0 berarti sudah selesai.

Status Flow SMM:

Pending arrow_forward In progress arrow_forward Completed

💡 Partial Orders

Status Partial berarti order tidak dapat diselesaikan 100%. Cek remains untuk mengetahui berapa yang tidak terkirim. Refund partial biasanya otomatis.

edit_note Customer Data (Note)

Beberapa produk memerlukan data customer yang dikirim melalui field note saat membuat transaksi.

Order Process	Note Content	Example
auto	Opsional (catatan untuk seller)	"Tolong pilih region SG"
manual	Opsional (instruksi ke admin)	"Email: [email protected]"
h2h	WAJIB - Nomor tujuan	"08123456789" / "12345678901"
smm	WAJIB - Link/Username target	"https://instagram.com/username"

Response Examples

Auto Process Response

{
  "message": "OK",
  "data": {
    "id": 99899,
    "ref_id": "TRX-001",
    "status": "completed",
    "items": [{
      "variant_id": 8,
      "variant_name": "1 Tahun",
      "product_name": "Spotify Premium",
      "product_license": "[email protected]|pass123",
      "order_process": "auto"
    }]
  },
  "h2h_results": [],
  "smm_results": []
}

H2H Process Response

{
  "message": "OK",
  "data": {
    "id": 99900,
    "ref_id": "TRX-002",
    "status": "completed",
    "items": [{
      "variant_id": 101,
      "variant_name": "Telkomsel 10K",
      "note": "08123456789",
      "order_process": "h2h"
    }]
  },
  "h2h_results": [{
    "variant_id": 101,
    "sn": "SN1234567890123456",
    "dispatch_status": "completed",
    "log_message": "Transaksi Sukses"
  }],
  "smm_results": []
}

H2H Failed Response

{
  "h2h_results": [{
    "variant_id": 102,
    "sn": "failed: Nomor tidak valid",
    "dispatch_status": "failed"
  }]
}

SMM Process Response

{
  "message": "OK",
  "data": {
    "id": 99901,
    "ref_id": "TRX-003",
    "status": "completed",
    "items": [{
      "variant_id": 201,
      "variant_name": "1000 Followers",
      "note": "https://instagram.com/user",
      "order_process": "smm"
    }]
  },
  "h2h_results": [],
  "smm_results": [{
    "variant_id": 201,
    "order_id": "98765",
    "status": "In progress",
    "start_count": 5000,
    "remains": 350
  }]
}

SMM Completed

{
  "smm_results": [{
    "variant_id": 201,
    "order_id": "98765",
    "status": "Completed",
    "start_count": 5000,
    "remains": 0
  }]
}