Logo Kabupaten Tapanuli Selatan
TrustMark PBB dan BPHTBSPLP v1.0

Portal Integrasi Layanan Basis Data Pajak

Portal Integrasi API

Oracle SISMIOP PostgreSQL BPHTB OAuth2 / API Key / HMAC Latency: <15ms

Katalog Layanan Interoperabilitas

Base: /api/v1
POST/api/v1/auth/tokenOAuth2 Token

Layanan penerbitan token akses JWT (Bearer) standar SPLP menggunakan Client Credentials untuk autentikasi mesin-ke-mesin (BPN Gateway).

Param: client_id, client_secret
GET/api/v1/pbb/nop/{nop}

Layanan penarikan data master Objek Pajak (Identitas Wajib Pajak, Alamat Letak, Luas Bumi, Luas Bangunan, NJOP) berdasarkan 18 Digit NOP.

Tabel: DAT_OBJEK_PAJAK, DAT_SUBJEK_PAJAK
GET/api/v1/pbb/sppt/{nop}

Layanan riwayat penetapan SPPT tahunan, nominal PBB terhutang, riwayat transaksi pelunasan, denda, serta status tunggakan pajak.

Tabel: SPPT, PEMBAYARAN_SPPT
GET/api/v1/pbb/znt/{nop}

Layanan Zona Nilai Tanah (ZNT), Nilai Indikasi Rata-rata (NIR) per m², rincian bidang bumi, dan estimasi nilai pasar/NJOP bumi.

Tabel: DAT_OP_BUMI, DAT_NIR, DAT_ZNT
POST/api/v1/pbb/bpn-validasi

Layanan validasi silang (cross-match) bidang tanah BPN (NIB, Luas Ukur) dengan data PBB untuk penerbitan sertipikat dan validasi BPHTB.

Payload: nop, nib, nomor_hak, luas_tanah_bpn
POST / GET/api/v1/bphtb/inquiryPostgreSQL

Layanan inquiry status pembayaran BPHTB, tanggal bayar, jenis bayar, dan nominal ketetapan dari basis data PostgreSQL (dbbphtb) berdasarkan NOP dan NTPD / Nomor STS.

Tabel: tbl_bphtb (nop, no_sts)

Kredensial Akses SPLP

Active

Semua endpoint API diproteksi sesuai standar regulasi SPLP. Anda dapat menggunakan salah satu dari metode autentikasi berikut:

Header API Key:X-API-Key
bpn-sismiop-pbb-secret-2026
Client ID (OAuth2):Client Credentials
bpn_splp_client

Kepatuhan Standar SPLP

  • OAuth2 JWT Bearer dengan masa berlaku token 3600 detik.
  • HMAC-SHA256 Signature untuk integritas data payload.
  • Replay Attack Prevention dengan toleransi timestamp ±5 menit.