API ANESA STORE

Cek Saldo

GET

Melihat saldo akun developer Anesa Store.

GET/v1/developer/balance

REQUEST

Autentikasi

Setiap request harus menyertakan header autentikasi berikut.

Simpan API Key dengan aman.Gunakan API Key hanya di sisi server dan jangan masukkan ke kode frontend.

HeaderDeskripsi

X-usernameUsername yang digunakan untuk mengakses Developer API.

X-API-KeyAPI Key yang digunakan untuk autentikasi request.

X-TimestampUnix timestamp saat request dibuat.

X-SignatureSignature HMAC-SHA256 dengan prefix sha256=.

SIGNATURE

Signature

Gunakan formula berikut untuk membuat signature HMAC-SHA256.

MESSAGEUSERNAME + API_KEY + GET + PATH + QUERY_STRING + TIMESTAMP

HMAC-SHA256HMAC-SHA256(message, API_KEY)

IP server developer harus sudah terdaftar pada whitelist.

Timestamp request harus masih dalam batas waktu yang diterima API.

Scope yang diperlukan: balance.read.

CONTOH REQUEST

cURL

Contoh request menggunakan endpoint dan parameter yang tersedia di API Anesa Store.

cURLbash

curl -i "https://api.showanesa.my.id/v1/developer/balance" \
  -H "X-username: USERNAME_ANDA" \
  -H "X-API-Key: API_KEY_ANDA" \
  -H "X-Timestamp: TIMESTAMP_ANDA" \
  -H "X-Signature: sha256=SIGNATURE_ANDA"

RESPONSE

Response

Berikut contoh response yang dikembalikan setelah request berhasil.

HTTP 200 — balance retrieved

application/jsonjson

{
  "rc": 200,
  "status": "success",
  "message": "balance retrieved",
  "data": {
    "available_balance": 100000,
    "reserved_balance": 0,
    "total_balance": 100000,
    "currency": "IDR"
  }
}

FieldKeterangan

available_balanceSaldo yang tersedia.

reserved_balanceSaldo yang sedang dicadangkan.

total_balanceTotal saldo akun.

currencyMata uang saldo.

CATATAN

Catatan

Beberapa hal yang perlu diperhatikan saat menggunakan endpoint ini.

IP server developer harus sudah terdaftar pada whitelist.

Signature dibuat tanpa newline tambahan pada message.

Timestamp request berlaku maksimal 5 menit.

Endpoint membutuhkan scope balance.read.