AAnesa StoreDokumentasi Integrasi
IDKembali ke Anesa Store
DokumentasiAPI Anesa StoreInquiry
API ANESA STORE

Inquiry

POST

Mengecek data pelanggan dan tagihan postpaid sebelum pembayaran dilakukan.

POST/v1/developer/inquiry
01
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 developer yang aktif untuk koneksi API.
X-API-KeyAPI Key aktif dan menjadi kunci HMAC-SHA256.
X-TimestampUnix timestamp saat request dibuat.
X-SignatureSignature HMAC-SHA256 dengan prefix sha256=.
Content-TypeWajib application/json untuk endpoint transaksi.

JSON body

FieldDeskripsi
ref_idWajib. Identitas inquiry yang dipakai kembali saat Payment.
anesa_sku_codeWajib. SKU produk postpaid Anesa Store.
customer_noWajib. Nomor pelanggan sesuai format produk.
yearOpsional. Tahun pajak untuk produk yang mendukungnya, 2000–2100.
extraOpsional. Untuk E-Money gunakan amount sebagai bilangan bulat positif.
02
SIGNATURE

Signature

Gunakan formula berikut untuk membuat signature HMAC-SHA256.

MESSAGEUSERNAME + API_KEY + REF_ID + 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: transaction.create.
03
CONTOH REQUEST

cURL

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

cURLbash
curl -i -X POST "https://api.showanesa.my.id/v1/developer/inquiry"   -H "Content-Type: application/json"   -H "X-username: USERNAME_ANDA"   -H "X-API-Key: API_KEY_ANDA"   -H "X-Timestamp: TIMESTAMP_ANDA"   -H "X-Signature: sha256=SIGNATURE_ANDA"   -d '{
    "ref_id": "REF-INQUIRY-001",
    "anesa_sku_code": "PLN-POSTPAID",
    "customer_no": "1234567890"
  }'
04
RESPONSE

Response

Berikut contoh response yang dikembalikan setelah request berhasil.

HTTP 200 — postpaid inquiry completed
application/jsonjson
{
  "rc": 200,
  "status": "success",
  "message": "postpaid inquiry completed",
  "data": {
    "ref_id": "REF-INQUIRY-001",
    "anesa_sku_code": "PLN-POSTPAID",
    "customer_no": "1234567890",
    "customer_name": "NAMA PELANGGAN",
    "admin": 2500,
    "status": "success",
    "periode": "202610",
    "selling_price": 52500,
    "desc": {
      "tarif": "R1",
      "daya": 1300,
      "lembar_tagihan": 1,
      "detail": [
        {
          "periode": "202610",
          "nilai_tagihan": "50000",
          "admin": "2500",
          "denda": "0"
        }
      ]
    }
  }
}
FieldKeterangan
ref_idReference ID inquiry.
anesa_sku_codeSKU produk postpaid Anesa Store.
customer_noNomor pelanggan yang diperiksa.
customer_nameNama pelanggan jika tersedia.
adminTotal biaya admin yang tercantum pada hasil inquiry.
statusStatus hasil inquiry. Pada inquiry berhasil bernilai success.
periodePeriode tagihan jika tersedia.
selling_priceHarga yang digunakan untuk client berdasarkan hasil inquiry.
descDetail tagihan.

Contoh response lainnya

Format detail pada response dapat berbeda sesuai jenis produk. Contoh berikut memakai field yang tersedia pada masing-masing produk.

PLN

HTTP 200
application/jsonjson
{
  "ref_id": "REF-INQUIRY-PLN",
  "anesa_sku_code": "PLN-POSTPAID",
  "customer_no": "1234567890",
  "customer_name": "NAMA PELANGGAN",
  "admin": 2500,
  "status": "success",
  "periode": "202610",
  "selling_price": 52500,
  "desc": {
    "tarif": "R1",
    "daya": 1300,
    "lembar_tagihan": 1,
    "detail": [
      {
        "periode": "202610",
        "nilai_tagihan": "50000",
        "admin": "2500",
        "denda": "0"
      }
    ]
  }
}

E-Money

HTTP 200
application/jsonjson
{
  "ref_id": "REF-INQUIRY-EMONEY",
  "anesa_sku_code": "EMONEY-POSTPAID",
  "customer_no": "081234567890",
  "customer_name": "NAMA PELANGGAN",
  "admin": 2500,
  "status": "success",
  "selling_price": 25000,
  "desc": {
    "lembar_tagihan": 1
  }
}

Samsat

HTTP 200
application/jsonjson
{
  "ref_id": "REF-INQUIRY-SAMSAT",
  "anesa_sku_code": "SAMSAT-JABAR",
  "customer_no": "KODE,IDENTITAS",
  "customer_name": "NAMA PEMILIK",
  "admin": 2500,
  "status": "success",
  "periode": "2026",
  "selling_price": 2500000,
  "desc": {
    "lembar_tagihan": 1,
    "alamat": "ALAMAT KENDARAAN",
    "nomor_identitas": "NOMOR_IDENTITAS",
    "nomor_rangka": "NOMOR_RANGKA",
    "nomor_mesin": "NOMOR_MESIN",
    "nomor_polisi": "D1234ABC",
    "merek_kb": "MEREK",
    "model_kb": "MODEL",
    "tahun_buatan": "2024",
    "tgl_akhir_pajak_baru": "20261231",
    "biaya_pokok_bbn": "0",
    "biaya_pokok_swd": "143000",
    "biaya_pokok_pkb": "2131500",
    "biaya_denda_swd": "0",
    "biaya_denda_bbn": "0",
    "biaya_denda_pkb": "0",
    "biaya_admin_stnk": "0",
    "biaya_admin_tnkb": "0",
    "biaya_parkir_pokok": "0",
    "biaya_pajak_progresif": "0"
  }
}
05
CATATAN

Catatan

Beberapa hal yang perlu diperhatikan saat menggunakan endpoint ini.

Hasil inquiry disimpan selama 10 menit dan dipakai sebagai dasar Payment.
Selama inquiry masih aktif, ref_id yang sama harus menggunakan SKU dan customer_no yang sama.
Setelah inquiry kedaluwarsa dan belum dipakai, ref_id dapat digunakan kembali.
Untuk E-Money, kirim extra.amount sesuai denominasi yang ingin diperiksa.