Reseller API — v1

Dokumentasi Integrasi

Integrasikan toko Anda ke RAZORSTORE. Sistem mendukung pencatatan saldo otomatis, validasi nickname langsung ke provider, dan diskon kupon member.

Autentikasi

Semua request ke API harus menyertakan tiga header berikut. API Key bisa ditemukan di halaman pengaturan akun reseller Anda.

Header
Accept
Nilai
application/json
Header
Content-Type
Nilai
application/json
Header (autentikasi)
x-api-key
Nilai
API_KEY_RESELLER_ANDA

Alur Validasi Nickname

Fitur ini mencegah transaksi gagal akibat kesalahan target.

1
Cek field check_status pada response /get-product. Jika nilainya "On", validasi wajib dilakukan sebelum order.
2
Kirim target ke endpoint /validate-nickname. Sistem akan memvalidasi data secara sinkron langsung ke provider.
3
Jika nickname tidak ditemukan atau salah, API mengembalikan error 422 dan saldo tidak dipotong.
01

Get Profile

Mengambil informasi akun reseller, saldo saat ini, dan level membership.

POST https://razorstore.id/api/v1/profile
Response — 200 OK
json 
{
  "success": true,
  "code": 200,
  "message": "Profile retrieved successfully",
  "data": {
    "username": "reseller_zann",
    "name": "Anantha Reseller",
    "email": "anantha@example.com",
    "balance": 750000,
    "whatsapp": "6281234567890",
    "level": "Gold"
  }
}
02

Get Products

Mengembalikan seluruh daftar produk aktif beserta status validasi nickname.

POST https://razorstore.id/api/v1/get-product
Response — 200 OK
json 
{
  "success": true,
  "code": 200,
  "message": "Products retrieved successfully",
  "data": [
    {
      "id": 1,
      "title": "Mobile Legends",
      "code": "MLBB",
      "slug": "mobile-legends",
      "category": "Game Mobile",
      "image_url": "https://razorstore.id/images/products/ml.png",
      "check_status": "On"
    }
  ]
}
03

Get Variants

Mengembalikan daftar varian produk beserta harga sesuai tier reseller Anda.

POST https://razorstore.id/api/v1/get-variant
Response — 200 OK
json 
{
  "success": true,
  "code": 200,
  "message": "Variants retrieved successfully",
  "data": [
    {
      "id": 42,
      "name": "86 Diamonds",
      "your_price": 18000,
      "price": 20000,
      "silver_price": 19000,
      "gold_price": 18000,
      "platinum_price": 17000,
      "product_code": "MLBB"
    }
  ]
}
04

Validate Nickname

Validasi nama akun tujuan sebelum submit order. Wajib dilakukan jika check_status produk adalah "On".

POST https://razorstore.id/api/v1/validate-nickname
Parameter Request
Parameter Tipe Wajib Keterangan
variant_id integer Ya ID varian yang akan dipesan.
target_1 string Ya ID akun game atau nomor tujuan.
target_2 string Tidak Server ID atau Zone ID (jika ada).
Request Body
json 
{
  "variant_id": 42,
  "target_1": "1374117562",
  "target_2": "15661"
}
Response — 200 OK (valid)
json 
{
  "success": true,
  "code": 200,
  "message": "Validation successful",
  "data": {
    "nickname": "ZannStorePlayer",
    "user_id": "1374117562",
    "zone_id": "15661",
    "status": "valid",
    "valid": true
  }
}
05

Create Order

Submit transaksi pembelian produk. Pastikan saldo mencukupi sebelum melakukan order.

POST https://razorstore.id/api/v1/order
Parameter Request
Parameter Tipe Wajib Keterangan
variant_id integer Ya ID varian dari /get-variant.
target_1 string Ya ID game atau nomor HP tujuan.
target_2 string Tidak Zone ID atau Server ID (bila ada).
coupon_code string Tidak Kode kupon diskon member.
Request Body
json 
{
  "variant_id": 42,
  "target_1": "1374117562",
  "target_2": "15661",
  "coupon_code": "PROMO10"
}
Response — 200 OK (diproses)
json 
{
  "success": true,
  "code": 200,
  "message": "Order placed successfully",
  "data": {
    "order_id": "ORD202606100001",
    "product_name": "Mobile Legends",
    "variant_name": "86 Diamonds",
    "price": 18000,
    "price_before_discount": 20000,
    "discount_amount": 2000,
    "coupon_code": "PROMO10",
    "target_1": "1374117562",
    "target_2": "15661",
    "nickname": "ZannStorePlayer",
    "status": "Processing",
    "description": "Order is being processed",
    "success_at": null,
    "created_at": "2026-06-10T21:51:36+08:00"
  }
}
06

Check Order Status

Melacak status terkini transaksi menggunakan ID order yang didapat dari /order.

POST https://razorstore.id/api/v1/check-status
Parameter Request
Parameter Tipe Wajib Keterangan
order_id string Ya ID order dari response /order.
Request Body
json 
{
  "order_id": "ORD202606100001"
}
Response — 200 OK (sukses)
json 
{
  "success": true,
  "code": 200,
  "message": "Order status retrieved successfully",
  "data": {
    "order_id": "ORD202606100001",
    "product_name": "Mobile Legends",
    "variant_name": "86 Diamonds",
    "price": 18000,
    "price_before_discount": 20000,
    "discount_amount": 2000,
    "coupon_code": "PROMO10",
    "target_1": "1374117562",
    "target_2": "15661",
    "nickname": "ZannStorePlayer",
    "status": "Success",
    "description": "SN: 1234567890987654",
    "success_at": "2026-06-10T21:52:10+08:00",
    "created_at": "2026-06-10T21:51:36+08:00"
  }
}