Dokumentasi API & H2H

Panduan integrasi resmi Sancaystore untuk reseller, sistem H2H, dan partner. Akses produk top-up game dan pulsa secara realtime via API kami.

⚡ Realtime Pricing 🔒 SHA-256 Sign 📡 Webhook Callback 🌐 99.9% Uptime

📘 Pengenalan

Sancaystore menyediakan dua metode integrasi:

API (POST) — untuk transaksi (order topup, deposit, cek status). Memerlukan autentikasi sign + secret.
H2H (GET) — untuk cek harga produk realtime. Cocok dipakai untuk web reseller / display harga otomatis.

💡 Base URL: https://sancaystore.com/api

🔑 Autentikasi

Setiap request POST butuh 3 parameter wajib:

Parameter	Keterangan
`username`	Username API kamu (didapat di menu API Integration setelah login).
`api_key`	API Key publik akun reseller.
`sign`	`md5(username + api_key + ref_id)`

⚠️ Jaga kerahasiaan api_secret. Jangan pernah ekspos di kode frontend / publik. Sign dihitung di server kamu.

🛰️ Daftar Endpoint

Method	Endpoint	Fungsi
GET	`/api/h2h/price-list`	Cek daftar harga semua produk realtime.
POST	`/api/order`	Submit transaksi topup baru.
POST	`/api/status`	Cek status transaksi by ref_id.
POST	`/api/balance`	Cek saldo akun reseller.

💰 Cek Harga (H2H)

GET /api/h2h/price-list

Contoh Request

curl "https://sancaystore.com/api/h2h/price-list?username=USERNAME&api_key=APIKEY"

Contoh Response

{
  "status": true,
  "data": [
    {
      "id": 6644,
      "layanan": "Mobile Legends 11 Diamonds (thailand)",
      "kategori": "Mobile Legends Thailand",
      "harga_public": 2679,
      "harga_member": 2666,
      "harga_silver": 2653,
      "harga_gold": 2640,
      "status": "available"
    }
  ]
}

🚀 Topup Order (API)

POST /api/order

Body Parameter

Parameter	Tipe	Wajib	Keterangan
`username`	string	✅	Username API.
`api_key`	string	✅	API Key.
`sign`	string	✅	md5(username + api_key + ref_id).
`ref_id`	string	✅	Reference ID unik dari sistem kamu.
`pulsa_code`	string	✅	Kode produk (id atau provider_id) — lihat di Daftar Harga.
`hp`	string	✅	Tujuan: untuk MLBB = userId+zoneId tanpa spasi (mis. `1234567891234`).

Contoh Request

curl -X POST "https://sancaystore.com/api/order" \
  -d "username=USERNAME" \
  -d "api_key=APIKEY" \
  -d "sign=SIGN_HERE" \
  -d "ref_id=ORDER-001" \
  -d "pulsa_code=4247" \
  -d "hp=1234567891234"

Contoh Response Sukses

{
  "data": {
    "ref_id": "ORDER-001",
    "status": "0",
    "message": "Process",
    "price": "24904",
    "tr_id": "PK1236026171",
    "rc": "39"
  }
}

📊 Cek Status Order

POST /api/status

Cek status order yang sudah pernah disubmit pakai ref_id yang sama. Response sama persis dengan response order awal, tapi status & rc akan ter-update.

🔔 Callback / Webhook

Setelah order selesai (Sukses / Gagal), Sancaystore akan kirim POST ke URL callback yang kamu daftarkan di menu API Integration.

Body Callback

{
  "data": {
    "ref_id": "ORDER-001",
    "status": "Sukses",
    "sn": "SN12345",
    "message": "Transaksi Sukses",
    "rc": "00"
  }
}

💡 Sistem kamu wajib reply HTTP 200 OK dalam 10 detik. Kalau tidak, Sancaystore akan retry 3x dengan jeda 30s.

🏷️ Kode Status (RC)

RC	Status	Arti
`00`	Sukses	Transaksi berhasil, SN keluar.
`03`	Pending	Order diterima, sedang diproses.
`06`	Gagal	Transaksi gagal final, saldo direfund.
`07`	Param Invalid	Parameter request kosong / tidak lengkap.
`14`	Gagal	Order ditolak provider.
`20`	Produk Invalid	Kode produk tidak ditemukan / nonaktif.
`39`	Pending	Order baru di-submit, menunggu callback.
`204`	Sign Invalid	Sign tidak cocok — cek username/api_key/ref_id.

💬 Bantuan & Support

Butuh bantuan integrasi? Hubungi tim support kami: