DokumentasiAPI Anesa StorePospaid
API ANESA STORE

Pospaid

POST

Membayar tagihan postpaid berdasarkan hasil Inquiry yang masih aktif.

POST/v1/developer/inquiry/payment
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 dan harus cocok dengan inquiry yang masih aktif.
anesa_sku_codeWajib dan harus sama dengan inquiry.
customer_noWajib dan harus sama dengan inquiry.
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/payment"   -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 202 — postpaid payment accepted
application/jsonjson
{
  "rc": 202,
  "status": "success",
  "message": "postpaid payment accepted",
  "data": {
    "ref_id": "REF-INQUIRY-001",
    "order_number": "ORDER_NUMBER",
    "status": "pending",
    "anesa_sku_code": "PLN-POSTPAID",
    "customer_no": "1234567890",
    "selling_price": 52500
  }
}
FieldKeterangan
ref_idReference ID dari inquiry.
order_numberNomor order Anesa Store.
statusStatus awal transaksi, yaitu pending saat order diterima.
anesa_sku_codeSKU produk postpaid Anesa Store.
customer_noNomor pelanggan yang dibayar.
selling_priceJumlah yang dibebankan kepada client berdasarkan hasil inquiry.

Contoh response lainnya

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

Transaksi berhasil

Webhook transaction.updated
application/jsonjson
{
  "event": "transaction.updated",
  "data": {
    "ref_id": "REF-INQUIRY-001",
    "order_number": "ORDER_NUMBER",
    "status": "success",
    "anesa_sku_code": "PLN-POSTPAID",
    "customer_no": "1234567890",
    "selling_price": 52500,
    "transaction_type": "postpaid",
    "updated_at": "2026-10-07T02:30:00Z",
    "sn": "SERIAL_NUMBER"
  }
}

Transaksi gagal

Webhook transaction.updated
application/jsonjson
{
  "event": "transaction.updated",
  "data": {
    "ref_id": "REF-INQUIRY-001",
    "order_number": "ORDER_NUMBER",
    "status": "failed",
    "anesa_sku_code": "PLN-POSTPAID",
    "customer_no": "1234567890",
    "selling_price": 52500,
    "transaction_type": "postpaid",
    "updated_at": "2026-10-07T02:31:00Z"
  }
}
05
CATATAN

Catatan

Beberapa hal yang perlu diperhatikan saat menggunakan endpoint ini.

Payment hanya dapat dilakukan dengan inquiry yang belum kedaluwarsa dan belum dipakai.
SKU dan customer_no harus sama dengan data pada inquiry.
Request yang berhasil diterima mengembalikan HTTP 202 dengan status pending; itu belum berarti pembayaran sudah selesai.
Status akhir dikirim melalui Webhook Anesa Store.
Serial number hanya dikirim pada webhook jika tersedia setelah transaksi diproses.