Skip to main content
POST
/
api
/
v1
/
order
Create Order
curl --request POST \
  --url https://app.sosmednext.com/api/v1/order \
  --header 'Content-Type: application/json' \
  --data '
{
  "service": {},
  "link": "<string>",
  "quantity": 123
}
'
Gunakan Endpoint ini ketika pelanggan pada Panel/Platform Anda menekan tombol “Buat Pesanan Baru”. Sistem kami di backend akan secara cerdas memvalidasi id layanan, mengecek batasan server minimal rate dan maksimal order, serta akan memotong saldo Anda secara otomatis sesuai harga API terbaik yang ditawarkan.

​
Body Parameters (JSON)

Endpoint ini membutuhkan tipe metode POST. Anda juga wajib memastikan Request Header Anda memuat properti spesifik yakni Content-Type: application/json.
​
service
integer atau string
required
ID Layanan yang ingin dipotong/dipesan (ID layanan ini Anda sinkronisasikan atau dapatkan dari respons endpoint GET /api/v1/services).
​
link
string
required
Target / URL / Destinasi pesanan pelanggan Anda (misalnya: @username Instagram, URL Link postingan TikTok videonya secara penuh, dll).
​
quantity
integer
required
Jumlah besaran pesanan yang Anda butuhkan (Harap cek, jumlah angka ini harus berada di dalam batas rentang min dan max dari informasi detail layanannya terkait).

​
Contoh Implementasi Request

​
Contoh Data Payload JSON

Format Body Type JSON
{
  "service": 12,
  "link": "https://instagram.com/user_client_1",
  "quantity": 1000
}
Request Terminal (cURL)
curl -X POST \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":12, "link":"https://instagram.com/user_client_1","quantity":1000}' \
  "https://app.sosmednext.com/api/v1/order"

​
Hasil Response Data Format

Jika validasi lolos dan sukses, saldo Anda akan terpotong secara otomatis oleh mutasi debit.
DOKUMENTASI PENTING: Anda wajib menangkap (parsing) hasil properti order (ID transaksi internal API layanan kami) dan menyimpannya pada MySQL/database sisi Anda! Karena properti ID ini esensial - akan Anda perlukan untuk melakukan pelacakan sinkronisasi di masa mendatang melalui endpoint Check Status!
Response Operasional Sukses (200 OK)
{
  "order": 9210,
  "invoice": "API1024322",
  "service": 12,
  "link": "https://instagram.com/user_client_1",
  "quantity": 1000,
  "charge": 15000.0,
  "status": "pending",
  "currency": "IDR",
  "remains": 135000.0
}

​
Penjelasan Komplit Field Payload:

FieldTipe DataKeterangan Fundamental
orderIntegerSUPER PENTING! Simpan tangkapan ID ini di tabel dalam database sistem/panel Anda, hal ini adalah ID Pesanan Provider unik yang Anda perlukan untuk mengecek Check Status kronologis pesanan.
invoiceStringNomor unik referensi/invoice pelacakan internal di billing Provider.
serviceIntegerReferensi ID layanan pada provider yang dicantumkan dan berhasil tereksekusi potong dari server.
linkStringTarget dari pesanan awal.
quantityIntegerAngka jumlah volume pesanan dikonfirmasi.
chargeNumberBiaya utuh yang sudah resmi dikenakan/dipotong dari balance Anda.
statusStringStatus tahap pesanan saat baru dibuat (pada umumnya akan bertuliskan pending pada proses inisiasi).
remainsNumberMutasi saldo: Sisa balance dana API final Anda setelah order ini selesai masuk tercatat tagihannya.

​
Pemecahan Masalah (Troubleshooting / Pesan Error Jika Order Gagal)

Response Saldo Anda Cekak (400 Bad Request)
{
  "error": "Insufficient balance. Required: 8500.00, Available: 5000.00"
}
Response Melebihi Batas Min/Max Limit Order (400 Bad Request)
{
  "error": "Quantity must be between 100 and 50000"
}