Spesifikasi secara umum
Berbasis API (Application Programming Interface), untuk Request dan atau Response atas Generate Kode Bayar (set_invoice), Info Pembayaran (get_payment);
Spesifikasi Fungsional
[Provinsi Jabar > Kota/Kabupaten]
Sebagai penghubung antara aplikasi pajak dan aplikasi pajak lainnya, atau antara klien dan server untuk memungkinkan integrasi data pajak antara dua aplikasi berbeda secara bersamaan tanpa harus menambahkan data secara manual seperti menerima data tagihan, meminta informasi pembayaran dan mengirimkan pesan dan atau data ke instansi tersentu secara periodik.
\nSpesifikasi System
\nFormat yang digunakan adalah json-rpc 2.0
\nAccess methode dengan request.post
\nAlamat Web Service
\nMethod adalah method yang akan di akses
\nAutentikasi
\nSetiap HTTP POST yang dikirim harus mengandung HTTP Header seperti berikut ini.
\nGenerate Signature
\ndef json_rpc_header(userid, password):\n utc_date = datetime.utcnow()\n inttime = int((utc_date-datetime.strptime('19700101 000000', '%Y%m%d %H%M%S')).total_seconds())\n value = \"%s&%s\" % (str(userid),str(inttime))\n key = str(password)\n signature = hmac.new(key, msg=value, digestmod=hashlib.sha256).digest() \n signature64 = base64.encodestring(signature).replace('\\n', '')\n headers = {'userid':userid,\n 'signature':signature64,\n 'key':inttime}\n return headers\n\nDigunakan untuk generate Kode Bayar
\nRequest Paramater
\nResponse Parameter
\n","urlObject":{"host":[""],"query":[],"variable":[]}},"response":[{"id":"2317ad13-d0a9-4107-8912-b50a281984dd","name":"set_invoice","originalRequest":{"method":"POST","header":[{"key":"userid","value":"","type":"text"},{"key":"signature","value":"","type":"text"},{"key":"key","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n\t\"jsonrpc\": \"2.0\",\r\n\t\"method\": \"set_invoice\",\r\n\t\"id\": 1,\r\n\t\"params\": {\r\n\t\t\"data\": {\r\n\t\t\t\"departemen_kode\": \"3215\",\r\n\t\t\t\"departemen_nama\": \"KABUPATEN SUBANG\",\r\n\t\t\t\"subjek_kode\": \"321503000001\",\r\n\t\t\t\"subjek_nama\": \"BENDAHARA PROVINSI JABAR\",\r\n\t\t\t\"objek_kode\": \"41012001\",\r\n\t\t\t\"objek_nama\": \"OPSEN PKB\",\r\n\t\t\t\"rekening_kode\": \"41012001\",\r\n\t\t\t\"rekening_nama\": \"OPSEN PKB\",\r\n\t\t\t\"dasar\": \"1000\",\r\n\t\t\t\"tarif\": \"1\",\r\n\t\t\t\"pokok\": \"1000\",\r\n\t\t\t\"pengurang\": \"0\",\r\n\t\t\t\"penambah\": \"0\",\r\n\t\t\t\"setoran\": \"0\",\r\n\t\t\t\"terutang\": \"1000\",\r\n\t\t\t\"denda\": \"0\",\r\n\t\t\t\"bunga\": \"0\",\r\n\t\t\t\"jumlah\": \"1000\",\r\n\t\t\t\"no_sk\": \"3215-2023-10-000001\",\r\n\t\t\t\"tgl_sk\": \"2023-10-27\",\r\n\t\t\t\"masa_awal\": \"2023-10-27\",\r\n\t\t\t\"masa_akhir\": \"2023-10-27\",\r\n\t\t\t\"jatuh_tempo\": \"2023-10-27\"\r\n\t\t}\r\n\t}\r\n}","options":{"raw":{"language":"json"}}},"url":""},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 07 Oct 2025 04:13:45 GMT"},{"key":"Server","value":"Apache/2.4.38 (Win64) OpenSSL/1.0.2q PHP/5.6.40"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Expect-CT","value":"max-age=7776000, enforce"},{"key":"Referrer-Policy","value":"no-referrer-when-downgrade"},{"key":"X-Powered-By","value":"PHP/5.6.40"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Headers","value":"Origin, X-Requested-With, Content-Type, Accept, userid, key, signature"},{"key":"Access-Control-Allow-Methods","value":"PUT, GET, POST, DELETE, OPTIONS"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Content-Security-Policy","value":"upgrade-insecure-requests"},{"key":"Content-Length","value":"131"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"jsonrpc\": \"2.0\",\n \"id\": \"3\",\n \"response\": {\n \"code\": 0,\n \"message\": \"Data berhasil disimpan\",\n \"params\": {\n \"data\": {\n \"kd_bayar\": \"32152023012604\"\n }\n }\n }\n}"}],"_postman_id":"c7e4017d-dfb6-422f-8e9e-648581873a6b"},{"name":"get_payment","id":"76438095-b3f9-4ab4-b655-08eaa42d84d9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"userid","value":"{{userid}}","type":"text"},{"key":"signature","value":"{{signature}}","type":"text"},{"key":"key","value":"{{key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n\t\"jsonrpc\": \"2.0\",\r\n\t\"method\": \"get_payment\",\r\n\t\"id\": 1,\r\n\t\"params\": {\r\n\t\t\"data\": {\r\n\t\t\t\"departemen_kode\": \"3215\",\r\n\t\t\t\"departemen_nama\": \"KABUPATEN SUBANG\",\r\n\t\t\t\"kd_bayar\": \"32152023012604\"\r\n\t\t}\r\n\t}\r\n}","options":{"raw":{"language":"json"}}},"url":"","description":"Digunakan untuk Informasi Pembayaran
\nRequest Paramater
\nResponse Parameter
\n","urlObject":{"host":[""],"query":[],"variable":[]}},"response":[{"id":"e6079d9f-a67d-4018-831d-53f1c1cd5992","name":"get_payment","originalRequest":{"method":"POST","header":[{"key":"userid","value":"{{userid}}","type":"text"},{"key":"signature","value":"{{signature}}","type":"text"},{"key":"key","value":"{{key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n\t\"jsonrpc\": \"2.0\",\r\n\t\"method\": \"get_payment\",\r\n\t\"id\": 1,\r\n\t\"params\": {\r\n\t\t\"data\": {\r\n\t\t\t\"departemen_kode\": \"3215\",\r\n\t\t\t\"departemen_nama\": \"KABUPATEN SUBANG\",\r\n\t\t\t\"kd_bayar\": \"32152023012604\"\r\n\t\t}\r\n\t}\r\n}","options":{"raw":{"language":"json"}}},"url":""},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 07 Oct 2025 04:17:16 GMT"},{"key":"Server","value":"Apache/2.4.38 (Win64) OpenSSL/1.0.2q PHP/5.6.40"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Expect-CT","value":"max-age=7776000, enforce"},{"key":"Referrer-Policy","value":"no-referrer-when-downgrade"},{"key":"X-Powered-By","value":"PHP/5.6.40"},{"key":"Set-Cookie","value":"os_session=4F%2BJMx0WPIfvF76ExB4D6IwAtQLGKf6YFKiNvP5npqEPHt1SBp0VevAUiMUVKSDR86ulMOemXTpDKc%2F8MtrNk1fKX7SWqVQKwfSV6mqLjrvXvIEOIghLiAP%2FM%2BE0F%2FgcJdutBMNJGYDNv1H05uUJjC1KiKI9btz4HSQSg11W6c3gn%2FRTLUxDpwPYZQhFXj9PS5vSORB3T4%2BfSTGRpmPcdiO%2F6cgG5tqMMVIN9D6JPVwtIa2F5%2Fy82c%2B%2BKNaTu38kZuqW1t7qTIDd5HXsulb7tqZeyDBnmY8mdqvrKdnAg9Zcxu7YhPTx5gepnT3VBP8mnjIzSRGlfjY1Tycp46ctCA%3D%3Dfbba6d8c3c39a3da01ef5637ec79560ccb10dd26; path=/"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Headers","value":"Origin, X-Requested-With, Content-Type, Accept, userid, key, signature"},{"key":"Access-Control-Allow-Methods","value":"PUT, GET, POST, DELETE, OPTIONS"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Content-Security-Policy","value":"upgrade-insecure-requests"},{"key":"Content-Length","value":"208"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"jsonrpc\": \"2.0\",\n \"id\": \"3\",\n \"response\": {\n \"code\": 0,\n \"message\": \"Data ditemukan, belum bayar.\",\n \"params\": {\n \"data\": {\n \"kd_bayar\": \"32152023012604\",\n \"tgl_bayar\": null, \n \"bayar_pokok\": \"0\",\n \"bayar_denda\": \"0\",\n \"total_bayar\": \"0\"\n }\n }\n }\n}"}],"_postman_id":"76438095-b3f9-4ab4-b655-08eaa42d84d9"}],"event":[{"listen":"prerequest","script":{"id":"1293aada-0b5d-48a1-b0a3-b4e575a79af1","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"70b6a6d1-61b0-41bb-ae62-e30c831e7519","type":"text/javascript","packages":{},"requests":{},"exec":["// dari environment atau collection variable\r","let userid = pm.variables.get(\"username\"); \r","let password = pm.variables.get(\"password\");\r","\r","let now = new Date();\r","let inttime = Math.floor(now.getTime() / 1000);\r","\r","let value = userid + '&' + inttime;\r","\r","let crypto = require('crypto-js');\r","let hash = crypto.HmacSHA256(value, password);\r","let signature64 = crypto.enc.Base64.stringify(hash);\r","\r","// Simpan hasilnya ke environment variable\r","pm.environment.set(\"userid\", userid);\r","pm.environment.set(\"signature\", signature64);\r","pm.environment.set(\"key\", inttime);"]}}],"variable":[{"key":"url","value":""},{"key":"username","value":""},{"key":"password","value":""}]}