Vehicle Tax Check

Method: POST
URL: {{baseUrl}}/kocek/vehicle-tax/check/:region/:collateral_id

Description

Mengecek status pajak kendaraan bermotor (PKB dan SWDKLLJ) melalui layanan Samsat online berdasarkan data kendaraan dari verifikasi sebelumnya. Endpoint ini digunakan untuk melihat apakah pajak kendaraan sudah dibayar atau masih memiliki tunggakan.

Data yang dikirim mencakup nomor polisi, NIK pemilik sesuai STNK, serta 5 digit terakhir nomor rangka (VIN).

Hasil yang dikembalikan mencakup:

• vehicle_info — informasi identitas kendaraan dan pemilik
• vehicle_tax_information — rincian pajak: pokok PKB, denda PKB (jika ada), sumbangan wajib, STNK, TNKB, PNBP, total yang harus dibayar, serta tanggal jatuh tempo pajak berikutnya

info

Endpoint ini menggunakan path parameter region dan collateral_id yang didapatkan dari hasil verifikasi kendaraan.

Request Headers

Key	Value	Deskripsi
Content-Type	application/json	-
Authentication	Bearer ACCESS_TOKEN	Akses token yang digenerate saat login

Request Body

Key/Field	Type	Contoh	Deskripsi
police_number	string	DK 1234 XX	No. polisi kendaraan
id_number	string	1234567891234567	NIK (No. KTP) pemilik yang terdaftar pada STNK
vin_number	string	09194	5 digit terakhir no rangka. Informasi ini bisa di cek pada STNK

Contoh Request

{
    "police_number": "DK 1234 XX",
    "id_number": "1234567891234567",
    "vin_number": "09194"
}

Responses

200 - Pajak Tahun Ini Belum Dibayar

Status: 200

{
    "data": {
        "vehicle_info": {
            "owner_name": "PUTRI MARTINA",
            "nik_number": "1234567891234567",
            "owner_address": "-",
            "license_number": "-",
            "vehicle_brand": "SUZUKI",
            "vehicle_type": "ARK415F GX (4X2) AT",
            "vehicle_model": "MINIBUS",
            "vehicle_year": "2016",
            "vehicle_color": "-",
            "chassis_number": "-",
            "vehicle_plate_color": "-",
            "fuel_capacity": "-",
            "ownership_status": "1"
        },
        "vehicle_tax_information": {
            "pkb_previous_date": "28-06-2024",
            "stnk_date": "-",
            "vehicle_information": "BELUM BAYAR",
            "pkb_pokok_amount": "Rp. 2,866,500",
            "pkb_denda_amount": "Rp. 0",
            "sumbangan_pokok_amount": "Rp. 143,000",
            "sumbangan_denda_amount": "Rp. 0",
            "stnk_amount": "-",
            "tnkb_amount": "-",
            "pnbp_amount": "Rp. 0",
            "total_amount": "Rp. 3,009,500",
            "pkb_upcoming_date": "28-06-2025"
        }
    },
    "message": "success check vehicle tax",
    "status": "success"
}

200 - Tardapat Tunggakan Pajak Tahun Sebelumnya

Status: 200

{
    "data": {
        "vehicle_info": {
            "owner_name": "Budi Setiawan",
            "nik_number": "1234567891234567",
            "owner_address": "-",
            "license_number": "-",
            "vehicle_brand": "HONDA",
            "vehicle_type": "V1J02Q32L0 A/T",
            "vehicle_model": "SPD MOTOR SOLO",
            "vehicle_year": "2018",
            "vehicle_color": "-",
            "chassis_number": "-",
            "vehicle_plate_color": "-",
            "fuel_capacity": "-",
            "ownership_status": "1"
        },
        "vehicle_tax_information": {
            "pkb_previous_date": "12-03-2024",
            "stnk_date": "-",
            "vehicle_information": "BELUM BAYAR",
            "pkb_pokok_amount": "Rp. 288,000",
            "pkb_denda_amount": "Rp. 72,000",
            "sumbangan_pokok_amount": "Rp. 35,000",
            "sumbangan_denda_amount": "Rp. 8,000",
            "stnk_amount": "-",
            "tnkb_amount": "-",
            "pnbp_amount": "Rp. 0",
            "total_amount": "Rp. 403,000",
            "pkb_upcoming_date": "12-03-2025"
        }
    },
    "message": "success check vehicle tax",
    "status": "success"
}

500 - Pembayaran Pajak Belum Bisa Dilakukan

Status: 500

{
    "error": "KENDARAAN BELUM BISA MELAKUKAN TRANSAKSI/PEMBAYARAN",
    "message": "failed check vehicle tax",
    "status": "fail"
}

500 - Kendaraan Perlu Pergantian STNK

Status: 500

{
    "error": "KENDARAAN HARUS MELAKUKAN PERGANTIAN STNK",
    "message": "failed check vehicle tax",
    "status": "fail"
}

401 - Unauthorized

Status: 401

{
    "status": false,
    "message": "Unauthorized",
    "data": null
}

403 - Layanan Tidak Aktif

Status: 403

{
    "error": "Layanan pengecekan pajak kendaraan sedang tidak tersedia",
    "message": "Layanan pengecekan pajak kendaraan sedang tidak tersedia",
    "status": "fail"
}