Autentikasi dan endpoint akun

Semua request cukup membawa satu header. Panggil GET /account untuk memastikan API key kamu berfungsi, melihat saldo dompet yang dipakai untuk membayar pesanan, dan mengecek akun masih aktif sebelum menjalankan batch.

Cara request diautentikasi

Header Authorization membawa kredensial Bearer berupa key ID dan secret yang digabung dengan titik. Key ID menentukan akunnya, sedangkan secret dicek lewat perbandingan HMAC. Kalau pengecekan gagal, jawabannya 401 dengan MISSING_API_KEY atau INVALID_API_KEY sebelum route-nya sendiri dijalankan. Selain itu tidak ada yang diperiksa: tanpa cookie, tanpa token CSRF, tanpa header origin.

Allowlist IP

Sebuah key bisa dibatasi ke sekumpulan alamat sumber. Selama daftar itu tidak kosong, request dari alamat lain ditolak dengan IP_NOT_ALLOWED dan HTTP 403, sebelum rate limit dan sebelum pengecekan dompet apa pun. Dengan begitu, kredensial yang dicuri tidak bisa dipakai di luar infrastruktur kamu sendiri. Daftar kosong berarti key bisa dipakai dari mana saja.

Status akun

Ada satu kondisi di level akun yang langsung menghentikan semua endpoint: akun yang dibekukan akan dibalas ACCOUNT_FROZEN dengan HTTP 403. Status ini tidak hilang dengan sendirinya, jadi serahkan penanganannya ke orang, bukan retry berulang dalam loop.

Rotasi key

Key dibuat dan dihapus di halaman API Access pada panel reseller. Secret cuma ditampilkan sekali saat dibuat, jadi rotasi berarti buat, deploy, lalu hapus, bukan edit langsung. Kredensial tidak punya masa berlaku otomatis, artinya jadwal rotasi sepenuhnya kamu yang tentukan.

GET

/account

Ambil Info Akun

Menampilkan detail akun, termasuk saldo dompet, status akun, dan tanggal akun dibuat.

Batas request60 req / 60 detik per akun

Permintaan

curl -s "https://shop2topup.com/api/endpoints/v1/account" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"

Contoh respons

{
  "success": true,
  "account": {
    "id": 42,
    "email": "[email protected]",
    "username": "partner_store",
    "client_type": "reseller",
    "wallet": "1250.500000",
    "enabled": true,
    "verified": true,
    "created_at": "2024-01-15T10:30:00Z"
  }
}

Coba kirim request langsung dari halaman ini

Tempel API key untuk memanggil endpoint ini secara live. Key hanya tersimpan di tab browser ini dan cuma dikirim ke API itu sendiri.

Enter your API key to use the interactive playground. Get your API key

Pilih endpoint

Enter your API key above to try this endpoint.

Response will appear here after sending a request.

Kalau baru pertama kali pakai platform ini, mulai dari ringkasan API top up game untuk reseller, atau baca ringkasan program reseller SHOP2TOPUP untuk tahu cara kerja akun partner.